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The Apple II Reference Manual contains a complete assembly listing of 
the Monitor program in the Apple TI. The Apple II Monitors Peeled 
Manual (this book) contains descriptions of the various routines in 
the Monitor and address tables arranged by topic instead of in the 
Hoquence of location within the machine. The material you find here 
has been chosen and organized to allow programmers of the Apple II to 
mnke convenient use of routines in the Monitor from their programs. 

Many of the CALI.able points in the Monitor fall under more than one 
topic. The layout of this book is intended to minimize the 
necessity of page flipping and cross referencing, so those points 
wtiich seem to bo appropriately described under more than one topic 
will be found in each applicable table. 

This document covers the Apple II Monitor (both the Old Monitor and 
l he Autostart Monitor versions), ROM address range $F800-$FFFF. This 
publication does not cover BASIC, APPLESOFT, DOS, HIRES, SUEET16, or 
Floating Point Arithmetic utility routines. 



INTRODUCTION 



There are two Monitor ROM's available for the. Apple II. The two 
Monitors are identical for most functions. They differ only in certain 
features. This book describes both Monitors, with indications provided 
whenever the information applies to only one of the two* 

Some thousands of Apple II computers have been shipped with the 
earlier version of the Monitor. In this book, that will be referred 
in as the Old Monitor. In 1979, a new version of the Apple II Monitor 
was developed. This Monitor contains new features to facilitate system 
Btart-up and program editing, at the expense of removing the 
Instruction trace and single step facilities and sixteen bit multiply- 
rllvide routine of the Old Monitor. This new Monitor is called the 
Autostart Monitor in this book. The Autostart Monitor is available 
from Apple Computer Inc. and from nany computer dealers under the 
name Autostart ROM, Apple Part No. A2M0027. 

It is easy to determine which Monitor is in a machine. Tf the machine 
comes up with the APPLE II legend at the top of the screen when the 
power is turned on, the machine contains the Autostart Monitor. If the 
machine comes up with the Monitor prompt (*) then it contains the Old 
Moni tor. 

A program can also determine whether the Monitor is the Old or the 
Autostart ROM. The byte at $FAFF (64255 or -1281) contains $00 in the 
Autostart and $01 in the Old Monitor. 
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OVERVIEW 



CHAPTER 1 

MONITOR US ACE MEMORY MAP 

Use of memory by the Monitor and by the Apple II for machine 
control and display to the screen. 

PAGE ZERO 

Description in detail of all memory locations in page zero imcd 
by the Monitor, indicating legal range of values and all routined 
which use the location. 

PAGES ONE THROUGH THREE 

General descriptions of pages one and two and specific 
description of fields in page three. 

PAGES FOUR THROUGH SEVEN AND ELEVEN 

Description of how text is maintained in "screen refresh memory" 
for display on the screen, both primary and secondary display 
areas for text and Low Resolution (Color) graphics. 

PERIPHERAL CONTROLLER WORK AREAS 

A chart showing the scratchpad areas available in RAM memory for 
use by peripheral controller programs. 

CHAPTER 2 

KEYBOARD INPUT DIVISION OF LABOR 

Descriptions of the lower level routines used by the Monitor to 
read data from the keyboard, including subroutines for cursor 
movement without reading characters. 

USER CALLS TO KEYBOARD INPUT ROUTINES 

Specifications for user calling of the routines at all levels for 
input of characters from the keyboard and for user program 
simulating (replacing) the keyboard as the input device. 

KEYBOARD INPUT MONITOR ROUTINE 

Table 1 contains addresses for character by character input from 
the keyboard via the routines described in the previous section. 
Table 2 contains addresses for line input from the keyboard. 

OVERVIEW - TEXT OUTPUT TO THE SCREEN 

Because there are so many ways to write text to the screen, this 
section contains an overview of the following pages on screen output 

TEXT OUTPUT WITHIN THE SCROLL WINDOW 

Detailed description of the normal method of printing data to the 
screen, as used by PRINT of BASIC, including page zero reference 
table for Scroll Window services. 
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SCREEN FORMAT CONTROL BY ROUTINE 

Table of addresses of routines in the Monitor which control the 
format of the Scroll Window and the format of data display. 

SCREEN FORMAT CONTROL BY POKE/STORE 

Description of methods of controlling the screen display format 
without calling routines in the Monitor. 

SCROLL WINDOW DATA MANIPULATIONS 

Table of routines which affect the data displayed in the Scroll 
Window, such as clearing part of it or scrolling it. 

CURSOR POSITION CONTROL 

Description of facilities for moving the cursor relative to 
current position or to an absolute location. 

GENERAL TEXT TO THE SCREEN 

Printing data to the screen whether some other device has been 
established (via CSWL) or not, and printing 30me things by a call 
to a Monitor routine which loads the A-reg and calls COUT itself. 

TEXT OUTPUT WITHOUT THE SCROLL WINDOW 

Ways and means of handling the screen as a formatted display 
device, with or without part of the screen being defined as a 
Scroll Window. 

SECONDARY DISPLAY AREAS 

Different methods of getting data into the secondary text display 



CHAPTER 3 

OVERVIEW OF INTERRUPT PROCESSING 

General and specific definition of interrupts and interrupt 
processing with regard to computers in general and the Apple II 
in particular. 

RESET INTERRUPT - OLD MONITOR 

Description of handling a RESET interrupt with address table 
allowing user call to subsets. 

RESET INTERRUPT - AUTOSTART MONITOR 

Description of handling a RESET interrupt with address table 
allowing user call to subsets. Description of Soft Entry Vector 
setup and use. 

IRQ/BRK INTERRUPT HANDLING 

Descriptions of handling these types of interrupts by both 
Monitors, with Address Tables. 
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CHAPTER 4 

MACHINE LANGUAGE DEVELOPMENT AIDS 

Address table for routines in the Monitor which can ho called to 
provide debugging information either by moving the informal Ion I" 
some other place in memory or printing information through CO'UT. 

LORES PLOTTING 

Descriptions of the routines in the Monitor which support this 
function, with a table of addresses for directly calling them. 

DATA MANIPULATION FUNCTIONS 

Description of the routines in the Monitor Which move datn from 
one place to another, or change the format, or operate on one- 
item with regard to another, 

MONITOR COMMAND PROCESSOR 

How to call the Monitor Command Processor, to have it execute 
Monitor commands and return to caller or stay in Monitor mode. 

SPEAKER (BELL) USE THROUGH THE MONITOR 

No music here. This is a description of how to use the speaker n» 
a signaling device in the same manner as the error alarm or RESET 
key alarm. 

CASSETTE TAPE INPI/T AND OUTPUT 

Description of all the routines involved with reading or writing 
of tape, with user call Information specified for the high level 
routines. Includes list of calling programs for each point. 

PADDLES, BUTTONS, AND ANNUNCIATOR I/O 

Description of paddle reading for the. machine language programmer 
and addresses to use for all these devices. 

WAIT ROUTINE 

This routine will take control of the machine for a length of 
time depending upon the input A-reg value. Table and formula arc- 
provided for use where interval between events is critical. 

USE OF CONTROL-Y WITH PARAMETERS 

Sample machine language program for rapid reading of the 
paddles. 

REGISTERS FOR BASIC MONITOR CALLS 

The Monitor GO command routine makes it possible to call from 
BASIC most Monitor routines which receive input in registers. 

DECIMAL TO HEX CONVERSION 

A saraple program that shows how to convert from decimal to 
hexadecimal . 

STEP AND TRACE PECULIARITIES 

Differences between operation of the machine with and without 
Single Step in the Old Monitor. 
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CHAPTER 1 

MEMORY ALLOCATION 

MONITOR USAGE MEMORY MAP 

Memory is divided into 256 byte sections, generally referred to as 

pages . As with most countable items in computers, memory pages are 
numbered from zero. Page 2ero is very special in that the full 
address of a byte in page zero nay be expressed in a single byte. 
Many 6502 processor instructions are only two bytes in length because 
the operand is in page zero. Thus, Monitor usage of page zero 
receives heavy treatment in the following section. 

Page one (address range $01tfl0-$01KF) is also special in the Apple II. 
This entire 256 byte area is called the "stack". The stack is a 
temporary storage area for which special instructions are provided in 
i he f>")02. The contents of the A-register or P-register may be pushed 
onto the stack, which means the contents of the indicated register 
are stored in the stack at the location currently specified by the 
S-register: then the S-register is decremented. Data may be pulled or 
popped from the stack, which means that the S-register is 
Incremented, and then the byte pointed at by the S-register is picked 
up into the appropriate register. A JSR instruction causes the 
current contents of the Program Counter to be pushed onto the stack 
before the jump. An RTS instruction pulls two bytes from the stack 
into the Program Counter. 

The Monitor contains instructions which use the stack. However, the 
Monitor does not initialize the stack pointer register to a preset 
value or load the S-reg at any time. 

Page two (address range $0200-§02FF) is defined in the Apple II as the 
keyboard input area. The Monitor routines which support reading of 
the keyboard store the information into page two for use by the 
calling program after the next carriage return is detected. 

Page three is address range $0300-$03FF. Most of this area is unused 
by the Monitor. Quite often the first 200 or so bytes are used for 
machine language programs called by APPLESOFT or BASIC programs. The 
Monitor uses only the last 16 bytes, as described in the Page Three 
Address Table. (Note, however, that DOS uses the 32 bytes before the 
Moii Iter's 16.) 

Pages four through seven comprise the primary text or color graphics 
display area. Pages eight thru eleven comprise the secondary text or 
color graphics display area when that feature of the Apple II is 
used. However, page eight is generally the first page of the user 
area. In the address table, pages four thru seven and eight through 
eleven are described together when specifying memory address per 
screen line. 
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From address $0800 to the end of memory in the machine is the user 
area for programs and data. However, if High Resolution Graphics is 
in use, then memory area from $2000 through $3FFF is the primary 
display area for that function and $4000 through $5FFF may be used as 
the secondary display area for that function. 



RAM MEMORY ALLOCATION BY ADDRESS 



00FF 



IPage zero 



0100 
01FF 



(Stack 



02FF 



I Keyboard Input 



0300 
03CF 
03 D0 
03EF 
03F0 
03FF 



I Avail able 

I DOS 

IVectors 
I 



0400 | Primary Text 
07FF land LORES Area 



0800 
0BFF 



2FFF 

3FFF 
4000 
5FFF 



I User Program 
land Data space 
I to RAM size. 

I ROM APPLESOFT 

I USER PROCRAM 

I 

| INTEGER 

I BASIC DATA 



Secondary Text 
and LORES 



Primary HIRES 



Secondary HIRES 



RAM APPLESOFT 
COMPILER/ 
INTERPRETER 



RAM APPLESOFT 
USER PROGRAM 



I 



3FFF 
7FFF 
BFFF -end 48K machine 



-end 16K machine 

I 

-end 32K machine 

I 
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PAGE ZERO 



The Monitor makes use of the page zero locatfons from 32 ($20) through 
73 ($49) for general functions and normal operations. Locations 74-77 
($4A-4D) are not touched by the Monitor. Locations 78-79 ($4E-4F) are 
modified as described below to provide a random number starting point 
for an application program. 

In addition, the Old Monitor uses locations 80-85 ($50-55) for the 16 
bit Multiply and Divide routines (which are available for problem 
program use but are not used by any other part of the Monitor). These 
locations are not used by the Autostart Monitor. 

The Autostart Monitor uses locations and 1 during system 
initialization. This initialization is described in the section on 
"RESET Interrupt - Autostart Monitor" and below in describing the use 
of locations and 1. 
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Dec flex Monitor 

Addr Addr Label 



01 



$00 LOC0 
$01 LOCI 



32 $20 



WNDLFT 



3 1 



$2 1 



WNDWDTH 



Description 

These locations are \ised by the Autostart Monitor 
during the automatic Disk Bootstrap function which 
takes place when the computer is powered up. Using 
these locations for indirect addressing, the slot 
addresses are checked - from slot 7 down thru 
slot 1 - to determine presence of a disk controller. 
If one is found, a Jump Indirect via $00-01 is 
executed to initiate the bootstrap operation. 

Left column of the Scroll Window: 
Range is to 39 ($27). 

This field is used only in VTAB7. which sets BASL.H 
to the memory location corresponding to CV and 
WNDLFT. The contents, when changed by user 
program, become effective on the next scroll 
operation, clear to end of page operation, or 
carriage return output. CH contains cursor 
horizontal position relative to (WNDLFT). 

After changing the contents of WNDLFT, either CALL 
V'TAB or print a carriage return to the screen to 
make it take effect. 

Width of the Scroll Window: 

Range is 1 to 40- (WNDLFT). 

When a character is written through COUT to the 

screen it is placed at (BASL),(CH), after which CH 

is incremented. Then (CH) is compared with 

(WNDWDTH) to determine whether the cursor has 

exceeded the right margin of the Scroll Window. 
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Dec Hex 
Addr Addi 



Monitor 
Label 



34 $22 WNDTOP 



35 $2 3 



WNDBTfl 



36 $24 



CT! 



37 



$2 5 



CV 



des cription 

Top line of the Scroll Window: 

Range is 9 to 22 (SJ6) for full text screen. 

Range is 20 to 22 (S14 and $15) for mixed graphics 

and text. 

Valid values for VTAB in Basics are 21, 22, 23. 

This field is used during a scroll operation to 

indicate the line on which the operation should 

start. It is also the line on which the cursor is 

placed on completion of a HOME operation (clear 

the window, place cursor at top left). 

Nominally, bottom line of Scroll Window: 

Range is (WNDT0P)-4-l to 24 ($18). 

WNDBTM contains the number of the first line below 

the Scroll Window. Contents of WNDBTM are tested 

only on output of a carriage return (S8D) or line 

feed ($8A). It is used by Clear to End of Page and 

by Scroll routines. 

Displacement from WNDLFT where next character to 
the screen will be placed: Range is 9 to 
(WNDWDTH) - 1. After the screen output routine 
STOADV places a character into the screen area as 
part of normal character output, CH is then 
incremented and compared to WNDWDTH. If CH is not 
less than WNDWDTH , a carriage return will he 
s imulatcd • 

Note that CH is used for echoing keyboard input to 
the screen by the Monitor GHTLN etc. routines. 

Vertical screen position (line number) for next 
character to be written to the screen: Range is (f 
to 23 ($17). The content of CV i s relative to the 
top of the screen, not to the top of the Scroll 
Window. It nay be set by loading the desired line 
number into A-reg and calling TABV. It may be set 
by POKEing the line number into CV and then 
calling VTAB. Actual storage of a character into 
the screen area includes use of BASL,H for line 
number, not CV. The calls above to VTAB or TABV 
are to sot BASL.H from CV (and WNDLFT) for 
Immediate future reference. 

If CV is at or below UNDBTM ft will remain on the- 
current screen line as carriage returns go by 
While the contents of the Scroll Window will be 
scrolled for each. 
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Dec Hex Monitor 

Addr Addr Label Descript ion 



38 

39 



40 



$26 CBASL 
S27 GBASK 



$28 
$29 



BASL 
BASH 



42 $2A BAS2L 

43 $2B BAS2H 



'<'' $2C 112 



LtlHKri 



RTML 



KMNEM 



RTHH 



tlomory address within the screen area of the left 
end point of the desired line for LORES plot. This 
field is set by the GBASCALC routine to the memory 
location appropriate for the line number specified 
in the A-reg. See "iftSK at $2E. 

This two byte field is the memory address for the 
left end character position of the current text line 
iine, within the Scroll Window. The contents are a ' 
function of CV and WNDLFT. 

This field is set by the BASCALC routine to point 
to the memory address for the left end of the 
screen line specified in the A-reg. This call to 
BASCALC is usually accomplished by the VTAB 
routine, which then adds (WNDLFT) to BASL.H to 
point to the left end of the line within the 
Scroll Window. 

This two byte field is used as a work area onlv 
during a scroll operation. It is the destination 
line pointer used as each line is moved to the 
position above current. 

Right end point of horizontal line being drawn by 
the HLINE routine: Range is to 39 ($27). 

This byte is set by the calling program before 
HLIHE is called. 

Low byte of two byte pointer (LMNEM, RMNEM) used 
by Disassembler as index to mnemonics table. 

Save area used by the Instruction Trace routine 
of the Old Monitor. 

Bottom point of a vertical line being drown by 
VLINE routine: RanRe is to 39 (S27) for mixed 
screen, to 47 ($2F) for full screen graphics. 
This byte must be set before VLIJ1E is called. Note 
that this byte is used when the Clear Screen 
(CLRSCR) routine uses VLIME to clear the screen. 

Used with LMNEM as table index for mnemonic table 
by the Disassembler. 

Used with RTNL as a save area by the Instruction 
Trace routine of the Old Monitor. 
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Dec Hex 
Addr Addr 



Monitor 

Label Description 



46 $2E MASK 



47 $2F 



With this label, this location is used as a $0F 
or $F0 by PLOT depending on whether the point is 
on the high side or the low side of the two 
horizontal plot lines represented by the GBASL,H 
pointer. Each location of the form (GBASI,), V 
contains two points on the screen, one above the 
other. MASK is used to set the appropriate one 
while leaving the other unchanged. 



FORMAT Using this label, the Disassembler uses this byte 
as temporary storage for the code which indicates 
the format of the instruction for display 

purposes. 

CHKSUM This byte is used during cassette tape read to 
continually accumulate the checksum which will 
be compared to that generated during the write 
operation which created the record. This byte is 
initialized to zero at the beginning of a tape 
read. As each byte is stored into memory it is 
Exclusively ORed against CHKSUM. After the last 
byte has been stored, one more byte is read from 

the tape and compared to CHKSUM. If equal, a good 
read nay be assumed. As this result is not finally 
stored back into CHKSUM, that field cannot be used 
by the calling program to determine success or 
failure of the read. A method for this 
determination will be found in the section 
"Cassette Tape Input and Output". 

LASTIN With this label, the RDBIT routine uses this byte 
as a work area to determine whether the sense of 
input from the cassette tape input register has 
changed. 

LENGTH This field is set by the Disassembler to indicate 

the length of the instruction. After output of the 
disassembled instruction, PCADJ uses this value to 
compute new values for PCI., 11, which are returned 
to caller in the A and Y reg for user storage to 
PCL,H. Instruction trace in the Old Monitor also 
uses this field to indicate the number of bytes to 
move to the instruction trace execution work area 
(XQT). 

SIGN After a call to MULPM or DIVPH (signed 16 bit 

multiply or divide in the Old Monitor), the $01 
bit of this byte is set if the always-posi tive 
result is to be complemented by the calling 
program. 
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Dec Ilex Monitor 

Addr Addr Label Description 



48 $30 COLOR 
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49 $31 



MODE 



r >0 $32 INVF1.G 



51 



$33 



PROMPT 



This byte contains the code for the color of 
points to be placed on the screen in graphics 
mode. The SF.TCOL routine is entered with a value 
in the low order four bits of the A-reg. This 
value is then placed in both the high and low 
nibbles of COLOR. COLOR is then used with MASK in 
setting the value of the byte in the screen area 
to accomplish setting a particular point to the 
selected color. 

Color can be set directly by stuffing the value 
multiplied by $11 in color. For example, 
color = orange (9): From assembly - LDA #99, 
STA color. From BASIC - POKF. 48, 9*17. 

This byte is used by the Monitor command 
processing routines to control parsing and to 
control operations when a blank is encountered 
after the hex digits. For example, a hex address 
followed by a colon causes setting of MODE so that 
during further processing of the input line each 
blank encountered signifies end of a hex value to 
be placed in memory. During parsing, the contents 
of MODE indicate where the hex values should be 
stored for use when the command itself is 
encountered. MODE is set to appropriate values by 
plus, minus, colon, and period. 

This byte is a mask used by C0UT1 to cause 
characters written to the screen area to display 
white on black (IMVFLG=$FF) or black on white 

(INVFLC=$3F) or blinking (INVFLG=$7F). This field 
is set to $FF when a RESET occurs by the routine 
at SETNORM. The routine called SETINV can be 

called to set reverse video. The Monitor does not 
set blinking. 

This byte contains the prompt character which is 
written to the screen by the Monitor GETLN routine 
in preparation for reading a line of characters 
from the keyboard. When the RESET key is pressed, 
the Old Monitor quickly enters the MOM routine, at 
which point the PROMPT field is set to $AA, "*". 
The Autostart Monitor also sets the "*" prompt 
character at the MOH routine, but this is not 
necessarily a part of processing the RESET 
interrupt . 
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Dec Hex Monitor 
Addr Addr Label 



r )2 



$34 



YSAV 



53 $35 YSAV1 



54 
55 



§36 
§37 



CSWL 
GSWH 



56 

57 



§38 KSWL 
$39 KSWI1 



58 
59 



$3A 
$3B 



PCL 
PCH 



Description 



This byte is a save area used by the Monitor 
Command Processor. The Y-reg is used by the 
Command Processor in indexing through the input 
line. When a command has been decoded, the Y-reg is 
saved at YSAV before" going to the selected service 
routine. On return to the Command Processor, the 
Y-reg is reloaded from here before transfer of 
control to NXTITM to continue scanning the input 
line. 

This byte is a save area for the Y-reg across a 
call to the screen output routines. Y-reg is saved 
and restored in the C0UT1 routine. 

This two byte field contains the address of the 
routine which is to receive and dispose of output 
characters. When the RESET key is pressed this 
field is initialized to point to C0UT1 to send 
output characters to the screen. Entering a 
Monitor Command nPc (n=port number, Pc=control-P) 
will cause the Monitor to set CSWL to 00, CSWH to 
Cn. The routine at that location will then receive 
(in the A-reg) each byte "written" through COUT, 
which is a JMP (CSWL). 

If the Monitor Command "0Pc" is executed, CSWL, II 
is set to point to C0UT1 instead of to C000. 

This two byte field contains the address of the 
user input routine. It is set by RESET key 
processing to point to KEYIN which gets its input 
from the keyboard. The Monitor Command nKc (n=port 
number, Kc=control-K) causes the setting of KSWL 
to 00, KSWH to Cn. This routine is then called any 
time the Monitor or executing program asks for 
another byte of input by calling RDKEY or one of 
the routines which in turn calls RDKEY. 

The Monitor Command "0Kc" results in setting 
KSWL.H to point to KEYIN instead of to C000. 

This field Is a save and control area for the 
Program Counter. In addition to the Mini Assembler 
to keep track of where the next instruction is to 
be placed. 

When a BRK instruction is executed, this field is 
set to indicate the address stacked by the 6502, 
pointing to two bytes beyond the BRK instruction 
executed . 



^ 



Doc Hex Monitor 

Addr Addr Label Description 
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60 $3C XQT 

XQTNZ 
61-67 $3D-$43 






60 

61 



$3C 

$3D 



All, 

A1H 



This field is used during Monitor commands L and G 
(Disassembler and Monitor "GOTO"). During 
disassembly of instructions this field is 
incremented as required. This field is used for a 
Jump Indirect in execution of the Monitor G 
command . 

Updating of this field is accomplished with the 
assistance of the PCADJ routine whenever use 
requires incrementing in accordance with the 
length of the instructions. (See LENGTH at 47 or 
$2F.) On return from PCADJ, store A to PCL and Y 
to PCH to accomplish update. 

This field is used by the Old Monitor in support 
of Monitor commands S and T (single instruction 
step and instruction trace). For those functions, 
it is maintained as a pointer to the next 
instruction to be handled. 

This field is used as a work area for instruction 
step and trace in the Old Monitor. The field is 
eight bytes long and overlays A1L.H; A2L.H; A3L.H; 
and A4L,H. The next instruction to be executed 
(indicated by the contents of PCL.H) is moved to 
this field, possibly modified depending on 
instruction type, and then executed here. This 
field is not defined in the Autostart Monitor. 

Multipurpose Monitor work area: 

May be clobbered by Instruction Trace in 

the Old Monitor; see XQT above. 

When the Monitor begins processing a command, MODE 
is initialized to zero. As the input line is 
scanned, hex digits are first placed into A2L,H. 
From there they are moved also to A1L,H and A3L,H 
as long as MODE remains zero. When a plus, minus, 
colon, or period is encountered, MODE is modified 
to indicate which, and A1L,H will continue to 
contain the value, terminated by the operator 
encountered. 

AlL.H is the primary index for the BLANK Monitor 
command, memory examine or display. 

AlL,H contains the addend for the Monitor ADD 
c ommand . 
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Dec Hex 
Addr Addr 



Monitor 

Label Description 



62 

63 



$3E 
$3F 



A2L 
A2H 



A1I,,H contains the minuend for the Monitor 
SUBTRACT command. 

A1L,H is the source field pointer during the 
Monitor MOVE command. 

A1L,H is one of the two indices used in the 
Monitor VERIFY command. 

A1L.H is the source field from which PCL.H is set 
on L and G Monitor commands, and the Old Monitor 
commands S and T, if an address is specified. If 
no address is used in the input line, then PCL.II 
is the residue of the last command which 
maintained or used it. 

A1L,H is the memory pointer used for cassette tape 
READ and WRITE Monitor operations. 

Monitor routine NXTA1 increments A1L,H by one and 
then compares the result to A2l,H. If A2L.11 is 
less than AIL, II, then Carry is set when control is 
returned to the calling program. 



Multipurpose Monitor work area: 
May be clobbered by Instruction 
the Old Monitor; see XQT above. 



Trace in 



This field is th 
data is stored f 
Command parsing, 
encountered, A2L 
entered. While 
minus, colon, or 
continually copi 
"less than" sign 
immediately copi 



e receiving field into which hex 
rom the input area during Monitor 

When the command itself is 
,H contains the last parameter 
MODE contains zero (until a plus, 

period Is encountered) A2L,H is 
ed into AlL.H and A3L.H. If a 

is encountered, A2L.H is 
ed to A4L,H and A5L.H. 



A2L,H is used to terminate examine (memory 
display), tape write, tape read, memory «ove, and 
memory verify operations. 

A2L.H contains the subtrahend in a Monitor 
SUBTRACT command operation. 

A2L,H contains the augend in a Monitor ADD command 
operation. 

A2L,H is the source field and A3L,H is raaintained 
as the pointer for the Monitor STORE command. 



i- m 

fe h 

k m 

fe M 

fe * 

fc Ji 

H M 

fe < 

h M 

fc m 

fe m 

fe » 

fc M 

fc ■ 

h Ji 

fc Si 

fc Ji 



Dec Hex Monitor 

Add r Addr Label Description 



A2L,H contains the port number in an input port 
select or output port select (control K or P) 
command . 

Monitor routine NXTA1 increments A1L,H by one and 
then compares the result to A2L,1I. If A2L,H is 
less than AIL,H then Carry is set when control is 
returned to the calling program. 

M $!>9 A3L Multipurpose Monitor work area: 

'i r > $41 A3H May be clobbered by Instruction Trace in the Old 

Monitor; see XQT above. 

All,, II and A31..H are both filled from A2L,H during 
Monitor Command processing scan of the input line 
as described above regarding A1L.H. 

A3I.,H is used as the destination pointer during 
Monitor STORE command processing. 

A3L.H is used as a work area by the Register 
Display routine, which is called by the control-E 
Monitor command, or as part of the single cycle or 
trace operations of the Old Monitor. 



66 $42 A4L Multipurpose Monitor work area: 

hi $43 A4I1 May be clobbered by Instruction Trace in the Old 

Monitor; see XQT above. 

This field (and A5L,1!) are loaded from A2L.1! 
during Monitor Command Processor scan of the injmt 
area when a "<" character is encountered. 

Ail,,!! is the receiving field pointer during a 
Monitor MOV?: command execution. 

A4], ) H is the second field pointer thirl ng a Monitor 
VERIFY operation. 

Monitor routine NXTA4 increments A4L.H by one, and 
then drops into NXTA1 , which increments All, ,11 by 
one and then compares the result to A2L,H. If 
A2L,H is less than Alt, I? then Carry is set when 
control is returned to the calling program. 
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Dec Hex Monitor 

Addr Addr Label Description 



68 
69 



$44 
$45 



A5L 
A5H 



NOTE: 

A5H = $4 5 = ACC 



69 $45 ACC 

70 $46 XREG 

71 $4 7 YREG 

72 $48 STATUS 
7 3 $49 SPOT 



74 $4A unused 

7 5 $4B unused 

76 $4C unused 

77 $4D unused 



Multi purpose Monitor work area: 

This field is not within the bounds of the area of 
XQT, which, in the Old Monitor, overlays AIL 
through A4II. 



This field is filled from A2i,,ll as described above 
for A4L,I1. However, the field is not otherwise 
referenced within the Monitor, except that ACC 
(below) is also A5H. 

This five byte field is a register save area. 
With the following exceptions, the 6502 registers 
are stored by the SAVE routine and reloaded by the 
RESTORE routine. 

S-reg is stored at SPNT by SAVE but is never 
reloaded . 

The A-reg is stored at ACC by the IRQ routine on 
either an IRQ interrupt or execution of a BRK 
instruction. On a BRK, entry into the RAVE 
routine at label SAV1 is used to store the rest 
of the registers. The other registers are not 
stored by the Monitor for an IRQ interrupt. 

As described above, the registers are scored in 
this area on execution of a RRK instruction. 

After execution of a BRK instruction or on 
execution of Monitor command control-E, the 
contents of this area are used to display the 
"registers" on the screen. 

The registers (except S-reg) are loaded from this 
area before jumping to the requested location on 
execution of the Monitor C command. 

In the Old Monitor Step and Trace command 
routines, the registers are stored here after each 
instruction execution and reloaded before the next 
traced instruction is executed. 
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f! m 

fc M 

e m 

k a 

h m 

t -m 

h m 

i- < 

fc * 

fc m 

i- -« 



Dec Hex Monitor 
Addr Addr Label 



78 
79 



$4E RNDL 
$4F RNDH 



80 


S50 


ACL 


81 


$51 


ACil 


82 


$52 


XTNDL 


83 


$53 


XTNDH 


84 


$54 


AIIX1. 


85 


S55 


AUXH 



Description 



Random number field, 16 bits: 

This field is continually counted up by the KEVIN 
routine while testing for key pressed. Thus, the 
results are effectively random as it doesn't take 
long to overflow and start over. There is no other 
reference to this field within the Monitor. 

These three two-byte fields are used only by the 
multiply and divide routines in the Old Monitor. 
These routines are not called from any place In 
the Monitor. Therefore, these fields are used 
only if a user program mokes use of the multiply 
or divide routines. 

The section on Data Manipulation Functions 
contains a full description of the multiply and 
divide routines. 



PAG ES ONE THROUGH THREE 

PAGE ONE ($0100-01 FF) 

Pflfte one is the hardware stack area. Monitor use of this area is 
only by means of the 6502 instructions which use the stack, such as 
I'll A . JSR, RTS, etc. The Monitor does not initialize or set the stack 
pointer (S-iegister ) on a RESET or Power On interrupt or at any other 

I line. 

PAGE TWO ($0200-02FF) 

Page two is the Keyboard Input buffer area. At label "CETLN" the 
X-ri-glster Is initialized as an index. At label AEDINP the character 
read from the keyboard is stored into page two indexed by the 
X-register. The result is that on return to the calling program the 
ilmr.ict ers read from the keyboard have been stored in memory locations 
V0/00 and up, the last character stored being a carriage return, 
cod.. $81). 

PAGE THREE ($0300-03FF) 

Page three contains "vectors" for special handling of certain 
Interrupts at the high end of the page. The low end of the page., 
through S03CK, is often used for machine language subroutines. 
I'rom $031)0 through $03EF is used by DOS. 
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PAGE THREE ADDRESS TABLE 



Hex 



Dec 



Function 



$0300-$03EF 768-1007 
$03F0-$03F1 1008-1009 

$03F2-S03F3 1010-1011 



$03F4 



1012 



S03F5-$03F7 1013-1015 
$03F8-$03FA 1016-1018 
$03FB-$03FD 1019-1021 
$03FE-$03FF 1022-1023 



Not used by the Monitor. 

The Autostart Monitor uses this location as the 
BRK instruction interrupt vector (address). 

This is the RESET (Soft Entry) Vector (address) 
used by the Autostart Monitor, as described in 

the section "RESET Interrupt - Autostart 

Monitor". 

Powered Up indicator: if the Exclusive OR of 
"$A5" with the contents of $03F3 is equal to 
the contents of $03F4 then the RESET (Soft 
Entry) Vector is considered valid. Otherwise, a 
RESET interrupt will cause the Autostart 
Monitor to go through power-up initialization, 
including boot of DOS if available. 

Reserved for APPLESOFT ("&" vector instruction). 

Control-Y Vector (instruction). 

Non-Maskable Interrupt Vector (instruction). 

IRQ Interrupt Vector (address). 



PAGES FOUR THROUGH SEVEN & ELEVEN 

Address range $0400 through S07FF is the primary text and low 

resolution graphics display area. That is, screen display hardware 
displays on the screen the information stored in this part of memory. 



Address $0800 is generally the beginning of memory available to the 
user for general program or data storage. However, $0800 through $0BFF 
is the secondary text and low resolution graphics display area. By 
POKEing -16299 with any value, the screen display hardware can be 
directed to display to the screen from this secondary display area 
instead of the primary display area. POKE -16300,0 to switch back to 
the primary display area. 

Although the hardware will display to the screen from the secondary 
display area, the Monitor does not siipport the. feature. That is, the 
BASCALC and GBASCALC routines in the Monitor convert the line number 
input to the routine to the appropriate memory address for the primary 
display area only. Use of the secondary display area is described in 
the section "Secondary Display Areas". 

Contiguous screen lines are not in contiguous memory locations. The 
characters on a screen line are in the same sequence in memory as on 
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I- * 

fe m 

K m 

fc m 

* m 

t s 

f- * 

f * 

i- * 

It * 

F * 

i- m 

fc * 

fc m 

h * 

t * 

h m 

fe * 

fc m 

f m 



the screen, but the lines are mixed in a manner which simplifies the 
hardware display to the screen. The following table indicates for each 
line the address in memory for the leftmost character of the line in 
both the primary and secondary display areas. 

The BASCALC routine in the Monitor computes the memory address for the 
line number input to that routine in the A-reg. Using the letters to 
designate bit positions in the input line number, the following 
Indicates the result of the computataion: 

Input line number (A-reg) 000ABCDE 

Memory address (BASH BASL) 000001 CD EABAB000 

This can be arithmetically computed, using "modulo" arithmetic in 
place of the ANDs and ORs of machine language. For line number 
"L" (0- 23), 

A-i1)R = l024+256*((L/2) MOD 4)+(128*(L MOD 2))+40*((l./8)MOD 4) 



SCREEN MEMORY ADDRESS TABLE 



Line Primary Display Area 
Decimal Hex 



Secondary Display Area 
Decimal Ilex 






1024 


0400 


2048 


0800 


1 


1152 


0480 


2176 


0880 


2 


1280 


0500 


2304 


0900 


3 


1408 


0580 


2432 


0980 


4 


1536 


0600 


2560 


0A00 


5 


1664 


0680 


2688 


0A80 


6 


1792 


0700 


2816 


0B00 


7 


1920 


0780 


2944 


0B80 


8 


1064 


0428 


2088 


0828 


9 


1192 


04A8 


2216 


08A8 


10 


1320 


0528 


2344 


0928 


11 


1448 


05A8 


2472 


09A8 


12 


1576 


0628 


2600 


0A28 


13 


1704 


06A8 


2728 


0AA8 


14 


1832 


0728 


2856 


0B28 


15 


1960 


07A8 


2984 


0BA8 


16 


1104 


0450 


2128 


0850 


17 


1232 


04D0 


2256 


08D0 


18 


1360 


0550 


2384 


0950 


19 


1488 


05r>0 


2512 


09D0 


20 


1616 


0650 


2640 


0A50 


21 


1744 


06D0 


2768 


0AD0 


22 


1872 


0750 


2896 


0B50 


23 


2000 


07D0 


3024 


0BD0 



ll Is also Interesting to note that although 24 lines of 40 characters 
computes to 960 bytes, the memory area described above contains 1024 
bytes per display area. The significance is that sone of the bytes in 
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pages four through seven are not displayed on the screen. These bytes 
are eight groups of eight bytes each. This space has been set aside or 
allocated for use by peripheral controller cards in slots one through 
seven. The following table shows the allocation. 

Misuse of these locations can be easily accomplished, with potentially 
serious results. Note that if an image of the screen is generated 
elsewhere and moved to this area in a block, the locations identified 
below will be modified. If a program is loaded from tape with the 
Monitor command mmmm.nnnnR, and if mnvnn is less than $0400, then the 
bytes in the following table will be loaded from the tape. If an 
attempt is made to save the screen area to disk and later BhOAD it to 
the screen area, results can be confusing. The Disk Controller card, 
and possibly some peripheral device interface cards keep control 
information in these areas. For example, doing the above mentioned 
BLOAD from drive 2 when the BSAVE had been done from drive 1 will 
result in the disk switching back to drive 1. 

The Reference Manual indicates that one must be sure that Scroll 
Window definition fields WNDLFT and WNDWDTH must not add up to more 
than 40. Violation of the bytes in the following table will be the 
unfortunate result if this caution is not observed. 

PERIPHERAL CONTROLLER WORK AREAS 



Commo n 




Slot 


Slot 


Slot 


Slot 


Slot 


Slot 


Slot 


(any/all) 


1 


2 


3 


4 


5 


6 


7 


Decimal 


Hex 
















1144 


0478 


0479 


04 7A 


04 7R 


047C 


047D 


04 7E 


047F 


1272 


04 F 8 


04F9 


04FA 


04FB 


04FC 


04 FD 


04FF, 


04FF 


1400 


0578 


0579 


057A 


057FS 


0570 


057D 


057E 


057F 


1528 


05F8 


05F9 


05FA 


05FB 


05FC 


05FD 


05FF, 


05FF 


1656 


0678 


0679 


06 7A 


067B 


067C 


067D 


067F. 


067F 


1784 


06F8 


06F9 


06FA 


06FB 


06FC 


06FD 


06FE 


06FF 


1912 


0778 


0779 


077A 


077B 


077C 


077D 


0771: 


077F 



2040* 07F8* 07F9 07FA 07FB 07FC 07FD 07FE 07FF 

* Location 2040 (S07F8) has special significance. This location should 
be loaded with $CN, where N is the slot number of the active 
peripheral, whenever an interrupt may occur and the ROM/PROM expansion 
scheme is in use. This is necessary so that the return from interrupt 
software used allows the proper peripheral card to resume operation. 
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fc 3 

h Jfl 

fc H 

I- H 

► a 

i- a 

fc m 

fc a 

f a 

i- m 

fc * 

fc m 

fc m 

fc * 

fc :* 

fc X 

h m 

fc :« 

fc a 

t * 

h m 



CHAPTER 2 

INPUT AND OUTPUT 

The default operation of the screen is as a scrolling device: new data 
is entered or output at the bottom of the screen and all above is 
shifted up line by line until the oldest information disappears off 
the top of the screen. With a little extra work in the user program, 
it is also possible to use the screen as a formatted display. 
Following is a description of the effects of that type of use, and 
some suggested solutions to the situations encountered. 

Characters generated by the user program for display on the screen are 
handed to the Monitor one character at a time. The screen output 
handlers check for control character vs. display character, and operate 
in accordance with what they find. For example, output of a carriage 
return character or line feed character while the cursor is on the 
bottom line of the screen will cause a scroll operation to take place. 
If the screen is being used with a format instead of as a scroll 
device, then the program can easily avoid output of a carriage return 
or line feed when the cursor is on the bottom line of the screen. 

The easiest way for the user program to read information from the 
keyboard is to call the Monitor at the point where it will read in a 
line (up to a carriage return) before returning control to the calling 
program. When this is done, the input information is always available 
at the same place in memory. There is, however, a conflict between 
using this type of a call and using the screen as a format type 
display. While the Monitor is receiving the keyboard input, it 
"echoes" the characters to the screen at the current cursor location. 
When end of input is signaled by a carriage return, the Monitor clears 
the cursor current line from cursor to the right end of the line 
(within the Scroll Window). Thus, the user program must make sure that 
before asking for input from the keyboard the cursor is placed where 
there is no significant data to the right. 

It is possible to divide the screen into scroll area and non-scroll 
area. Many complications arise from this method of operation, so the 
recommended solution to the format display problem is to leave the 
screen full scroll and avoid scroll services when they are not 
desi rable. 

The entry points and qualifiers for using scroll and non-scroll areas 
will be found in the section on Text Output Without the Scroll Window. 

KEYBOARD INPUT DIVISION OF LABOR 

The Monitor routines supporting keyboard input are designed to echo 
the keyboard input to the screen (through GOUT) at the current cursor 
position, and store the entered characters in the. keyboard input area 
(S0200-$02FF) for the convenience of the calling program. The 

executing program may position the cursor anywhere (In the Scroll 
Window) before calling the Monitor keyboard input routines. On entry 
of a carriage return from the keyboard, the Monitor keyboard input 
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routines will cause return of control back to the calling program witli 
the character count plus one in the X-register and a carriage return 
in the input area as a terminator. The program need not look into the 
screen refresh memory to determine what was entered. (Note: The X- 
Register begins with a zero, so that if five characters are entered, 
the X-Register will reflect 4, although the actual value returned 
will be 5. X is incremented for the carriage return as well. 

The routines described below are Included In the address table. The 
following section, "User Program Calls .••", describes program setups 
for calling some of these entry points. Hex address, + Decimal 

address, and - Decimal address are given in brackets beneath each 
routine. 



TABLE OF ROUTINES 

Routine Description 



GETLNZ 
[SFD67] 
[64871] 
[- 665] 

GETLN 
[$FD6A] 
[64874] 
[- 662] 



NXTCHAR 
[$FD7 5J 
[64885] 
[- 651] 



Entry at this point causes output of a carriage return 
(through COUT) before going to GETLN to write the prompt 
character and read the data. 



Entry at this point is with the cursor properly positioned 
(CV, BASL,H, and CH) as described in the section regarding 
Text Output Within the Scroll Window. 

GETLN prints the prompt character and initializes X-reg for 
indexed storage of the input characters into the input area. 
Control then goes to NXTCHAR. 

This is the top point in the character input loop. RDCIIAR 
is called to get a character into the A-reg. On return the 
A— reg is tested for presence of the control-U (right arrow on 
the keyboard) and if it is found, the A-reg is then loaded 
from the screen refresh memory ((BASL),Y), assuming that the 
Y-reg contains the same value as CH. 

If the A-reg value is $E0 or greater, the lower case letter 
is converted to upper case by AND with $DF. The character is 
then stored from the A-reg to the input area. 

If the character is a carriage return, CLREOL is called to 
clear to blanks the rest of the window line, and then a 
conditional branch transfers control to COUT so that the RTS 
exit of COUT will return control to the calling program with 
the X-reg indicating the input character count +1. That is, 
the input is in memory locations $0200 through $0200, X where 
$0200,X contains the carriage return. 

If the character Is not a carriage return, then control is 
transferred to the NOTCR routine for display on the output 
device, and for interpretation with regards to control 
character affecting the input line. 
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F 


m 




1- 
K 


m 
m 
m 


Routine 

NOTCR 
[$FI)3D] 
[64829] 
1- 707] 


fc 


m 




fc 


m 




ft: 


m 




fc 


m 




fc 
fc 


3 

m 


NOTCR 1 
|$F!)5F] 
[64863] 
[- 673] 


fc 


m 




fc 
fc 


m 
m 


CANCEL 
I $FD62 ] 
164866] 
[- 670] 


fc 
fc 


m 
m 


11CKSPC 
[$FI>7i] 
164881] 
1- 655] 


fc 


m 




fc 
fc 
fc 


m 
m 


KDCIIAR 
ISKD35] 
[64821,' 
1- 715J 


fc 


m 




fc 


m 




fc 


m 




fc 


m 




* M 





de scription 

This routine receives control with the character of interest 
in (IN,X). The current setting of INVFLG is saved on the 
stack, while INVFLG is set to $FF so that the character 
"echoed" to the screen will be white on black. COUT is then 
called with the character in the A-reg. 

On return from COUT, INVFLG is restored from the stack. The 
character at IN,X is then tested for either of two special 
keys: Backspace (left arrow) or (line) Cancel (control-X). 
If Backspace, go to BCKSPC. If Cancel, go to CANCEL. 

If (IN,X) is neither Backspace nor Cancel the value of X-reg 
is tested to determine whether the input area is full or 
almost full. If there are more than 247 characters in the 
input area, a call to BELL is used to signal to the operator 
that the area is almost full. 

After or without the margin warning bell, this routine gets 
control. Here, the X-reg is incremented to point at the 
next location in the input area to be filled. If, however, 
the result is overflow to zero, then entry of the Cancel key 
is simulated by falling into CANCEL. In the normal case, 
after incrementing the X-reg, control goes back to NXTCHAR 
to continue with character input and line building. 

This routine prints a back-slash through COUT to Indicate 
the action taken to the operator. Control is then passed to 
GETLNZ to initialize for entry of a new input line - the old 
one is gone. 

On entry to this routine, the backspace character has 
already been printed through COUT with resulting backward 
movement of the cursor. If the current value in X-reg is 
zero, control is transferred back to GETLNZ for printing 
prompt and re-initializing for line input. Otherwise, the X- 
reg is decremented with control going to NXTCHAR to resume 
input of characters. 

This routine calls RDKEY to get the next character placed 
into the A-reg. If, on return, it is found that the Escape 
key has been pressed, this routine calls the appropriate 
routine for reading the next character and performing the 
requested Escape key function. In the Old Monitor, control 
is passed to the ESC1 routine for this purpose, after a JSR 
to RDKEY to read the next character. In the Autostart 
Monitor, detection at KDCIIAR of an Escape character transfers 
control (via ESC including RDKEY) to ESCNEW, which has the 
capability of handling multiple escape functions after a 
single depression of the Escape key. 

After any requested escape functions have been performed, 
control returns to RDCIIAR as if there had been no 
1 nterruption. 
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Routine Description 



RDKEY 
l$FD0C] 
[64780] 
[- 756] 



KEYIN 
I$FD1B] 
1647951 
[- 741J 



ESC 

[SFD2F] 

[64815] 

r- 7211 



ESCNEW 
[$FBA5] 
[64421] 
[-1115] 



This routine picks up and saves in the A-reg the character 
from the screen refresh memory area at BASL.H.CH (leaving 
the Y-reg filled with the contents of CH). It then changes 
that character in memory to blinking to indicate current 
cursor position. 

This routine asks for the next input character to be placed 
in the A-reg by doing an indirect jump via KSWL.H, which is 
normally pointing at KEYIN. Return is therefore to the 
caller of RDKEY, not to the RDKEY routine itself. 

This is the routine which gets the next input key from the 
keyboard hardware. There are two required actions and two 
extra actions taken by this routine. The required actions 
are reading the keyboard input buffer over and over again 

until it is determined (by presence of the $80 bit) that a 
character has indeed been read. In this case, keyboard input 
buffer refers to the $100 byte buffer at $200, and not to 
the location at $C000. The sign flag is set or not by 
checking the status of the value at $0000. If that value is 
positive, the routine loops back to KEYIN. If that value is 
negative, the value of $C000 is picked up and the keyboard 
strobe is referenced to prepare for the next keyboard input. 

The auxiliary actions taken by this routine are first, to 
count up the random number field, ignoring overflow, and 
second, to restore to the screen area the character modified 
by the RDKEY routine to remove the blink. This restore is 
accomplished by storing the A-reg at (BASL),Y, assuming that 
RDKEY loaded it. This is accomplished before the keyboard 
register is read into the A-reg. 

Return to the caller (of RDKEY) Is accomplished by an RTS. 

Tills routine is entered from RDCMAR if the A-reg is found to 
contain the Escape key code. It reloads the A-reg with a new 
key by calling RDKEY. In the Old Monitor, It then calls ESCi 
to perform the requested single function. In the Autostart 
Monitor, ESCHEW is called to perform the requested functions. 
In either case, ESC is positioned such that the RTS which 
terminates Escape key processing returns control to RDCMAR. 

This routine exists only in the Autostart Monitor. It is 
the routine which supports cursor movement without data 
transfer; the Escape key functions I, J, K, and M. If the 
key next pressed is one of these four, the appropriate "old" 
function (Escape functions C, B, A, and D, respectively) is 
called. On return to ESCNEW, RDKEY Is again called to get 
(and operate upon) the next character from the keyboard. 



fc 
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Routine Description 

If the key pressed is not I, J, K, or M, then ESCI is 
entered by JMP Instead of JSR so that the RTS will return to 
the caller of ESCNEW instead of to ESCNEW. 

ESCI In the Old Monitor this routine is called by the RDCIIAR 

|$KC2C| routine If the Escape key code is found in the A-reg by that 
1645561 routine. In the Autostart Monitor, control is passed in this 
[- 980) case to the ESCNEW routine which then calls ESCI or jumps to 
it depending on which key is pressed next. 

ESCNEW translates I, J, K, or M to C, B, A, or D 
respectively before calling ESCI, which returns to ESCNEW. 

If the key Is other than I, .1, K, or M, then ESCNEW JMP's to 
ESCI with Carry set, to have the appropriate function 
performed. In this case, the next RTS will return control 
to the RDCKAR routine. 

When ESCI is called, the contents of the A-reg (and the 
condition that Carry is "set") indicate the action to be 
taken. Control is transferred (conditional branch) to the 
appropriate Scroll Window Service routine to move the cursor 
without transferring data, or to clear all or some of the 
screen, or some combination of these. 



CALLS TO KEYBOARD INPUT ROUTINES 

The following paragraphs describe how to set up for calls to the 
various entry points in the Monitor for keyboard input, and what the 
results will be. 



TABLE OF KEYBOARD INPUT CALLS 



Rout Ino 



CE'I'I.N/, 
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Description of S e it _-U p 



Write carriage return and prompt character, then read a line. 

Set-Up: 

X-reg, Y-reg, and A-reg are insignificant. 

CH is Insignificant. 

CV should point to the line in the Scroll Window where 

input is to begin. 
BASl.,11 is insignificant. 

Results : 

CR is written, scroll takes place if appropriate. 
Prompt character is written through COUT. 

Keyboard is read character by character. Each character 
is placed at $0200, X and X is then incremented. 
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Routine Description 

Each character is "echoed" to the screen at cursor 
position and the cursor is then advanced. 

On reading a carriage return, control is returned to 
calling program. 

On Return: 

A-reg contains a carriage return code ($8D). 

X-reg contains the number of characters read before 

carriage return. 
Y-reg contains contents of WNDWDTH. 
Location $(1200, X contains a carriage return. 
CH contains zero. 

CV contains line number, current value. 
BASL.H contains memory address for CV, WNDLFT. 
Window line is blank to the right of the end of the 

echoed input. 

GETLN Write prompt character, then read a line. 

Set-Up S 

X-reg, Y-reg, and A-reg are insignificant. 
CV and BAS1.,H should be compatible, pointing in the Scroll 
Window. 
CH indicates where on that line the prompt character is to 

be placed, to be followed by the echoed key input. 
Line address at which input is to begin must be in 

BASL.H. The Line number in CV will be calculated and 
set in BASL.H after a carriage return has been entered. 

Results : 

Same as above for GETLNZ, with noted exception. 

On Return: 

Same as above for CETLNZ. 

NXTCHAR Enter here to bypass print of prompt character to the screen. 

Set-Up: 

X-reg should be zero to begin storing input at $0200. 
Y-reg and A-reg are insignificant. 

CV and BASL.H should be compatible, pointing in the Window. 
CH indicates where echoing of keyboard input is to start. 

Results: 

Same as above for GETLN. 

On Return: 

Same as above for GETLNZ. 

Note: For all the above, Escape key functions are supported as 
described in the reference material for the Monitor you have installed. 
Also, control-U (right arrow) is supported. When that character is 
recognized in ttie keyboard buffer, it is replaced in the A-register by 
the contents of the screen memory at the current cursor position. 
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Description 

RDCHAR Read single character thru KSWL: return to caller in A-reg. 

Set-Up: 

X-reg is insignificant, and will not be clobbered. 

Y-reg is insignificant. 

A-reg is insignificant. 

CV and BASL.H should be compatible, pointing in the 

Scroll Window to the line where input is to begin. 
CH indicates the horizontal position in the Scroll Window 
where cursor position will be indicated by blinking. 

Results: 

The screen character at the cursor position (BASL),(CH) 

will be set to blinking until a key is pressed. 
If the Escape key is detected, the appropriate routines 

will be called to handle the requested function. 
Cursor right arrow (control-U) will be returned to the 

calling program, not the contents of the screen at the 

cursor. 
Cursor left arrow key (control— H) will be retvirned to the 

calling program. 
Characters read from the keyboard will not be stored in 

the $0200 area. 
After the character is read, the blink will be turned off 

at the cursor position, but the key just read will not 

be echoed to the screen, nor will the cursor (CH) be 

advanced. 
Cancel input line (control-X) service is not defined 

as the data is not being stored in the $0200 area. 
No special note is taken of carriage return, because the 

rest of the Monitor KEYIN Routine is not called. It is 

up to the calling program to take appropriate action on 

entry of a carriage return. 

On Re t ur n : 

A-reg contains the value of the key pressed. 
Y-reg contains the contents of CH. 
X-reg is not affected by the routines called. 
CV, CH, BASI.,11 will have changed only if an Escape key 
function has been utilized. 

Read single character thru KSWL: return to caller in A-reg. 

Set-Up: 

X-reg, Y-reg, and A-reg are insignificant. 

CV and BASL,H should he compatible, pointing in the 

Scroll Window. 
CH indicates the horizontal position where the cursor will 
he shown by blinking. 
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Routine Descripti on 

Resul ts: 

The character on the screen at the cursor position is aei 

to blinking. 
KEYIN routine is Riven control via (KSWL) for physical 

reading of the keyboard. 
Return (RTS) in KEYIN returns to the caller of RDKEY, not 

to the RDKF.Y routine. 

On Return: 

A-reg contains the character from the keyboard. It nay 

be any character, including Escape, carriage return, 

right or left arrow, or any other control character. 
X-reg is unchanged from the call. 
Y-reg contains the contents of CH. 
The character in the screen area at the cursor position 

has been restored to whatever it was before it was sot 

to blink by RDKEY. 
CV is used to. calculate the new line. 
BASL,H reflects the recalculated address. 
CV remai ns unchanged . 

KEYIN Read single character from keyboard: return to caller In A-reg. 

Set-Up: 

X— reg is unused and unaffected across this routine. 
A-reg input to this routine is what will be stored into 

the screen area at the cursor position (BASL),Y to 

remove , the blink condition after a key is pressed. 
Y-reg is set to be used to store the A-reg into the screen 

area to remove the blink at (BASI,),Y. 
CH and CV are not referenced, but should be appropriately 

set. BASL,H are used as described for A-reg and Y-reg 

above. 

Results: 

On return to the caller, only the A-reg has been changed. 
It contains the input from the keyboard register. 

KEYIN ROUTINE REPLACEMENT 

There are cases in which it is desirable to replace the physical 
keyboard input routine with a routine which either reads from the 
keyboard and preprocesses the input, or gets the Information to feed 
to the reading program from some source other than the keyboard. The 
requirements of such a program in replacing the KEYIN routine are 
described below. Placing the program/routine into effect is 
accomplished by storing the entry point in KSWL.H. 
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The replacement routine should manage the following resources as 
I nd lea ted . 

A-reg Store the A-reg at (BASL),Y, then load the A-reg from 

whatever source is to be used. 

X— reg Must be unaltered. Save on entry and restore on exit if 

it must be used by the replacement routine. 

Y-reg Use as indicated above for A-reg. 

It must not be changed on return from contents on entry, 
so save and restore if it must be used otherwise. (This 
caution is not required, however, if the source of the 
input prevents Escape key and right arrow from being 
entered. In such case, the Y-reg is expendable.) 

CH These are all used for echoing the "keyboard" input, 

CV so the replacement routine should either leave them 

BASL,H alone or manipulate them in an appropriate manner. 

NOTE: On replacing the pointer to KEYIN at KSWL.H, it is generally 

safer to pick up and store the current contents of KSWL,H in a 
save area before placing the address of your routine, and then 
restore KSVL.H from that save area when taking the replacement 
routine out of service. 

NOTE: If you replace the contents of KSWL,H with the address of your 
routine while using DOS, expect the unexpected. DOS uses both 

CSWL,1I and KSWL, II, and periodically restores them to appear the 
way DOS likes to see then regardless of current contents. 
Depending upon your application, it may be a good idea to 

replace both pointers on a temporary basis so that echo to the 
screen will not pass through DOS. But remember to repair both as 
soon as possible. 

KEYBOARD INPUT MONITOR ROUTINE 

There are many points in Keyboard Service which a user program could 
useful ly call. However, because they are generally different locations 
In i continuous string of instructions, and all instructions after the 
point of entry will be used, sections of this table of addresses are in 
Monitor sequence rather than in sequence by potential usability. 

Note that once the Monitor is jumped to at the specified point, all of 
i lie Initialization described after that entry point is also performed. 
Tli 1 8 Is implied by the & at the end of each function description. 
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ADDRESS TABLE 1 -CHARACTER INPUT 



Function 



Ilex +Dec -Dec Monitor Rep, Ik tern 
Addr Addr Addr Label Destroyed 



BOTH MONITORS 

Call RDKEY to 

into A-reg. 

Compare to $9B (Escape). 
If » BR to ESC to call for next 
character and do Escape function. 
Else, RTS. 
Set screen to blink at cursor 
saving original character in the 
A-reg from (BASL) ,Y & 

Jump Indirect (KSWL) to KEYIN 

Increment random number at RNDL.H 

while polling keyboard register. 
Store A-reg to (BASL),Y (clear 

blink set by RDKEY routine). & 

Load A-reg from keyboard register 

and clear keyboard strobe and RTS. 

Using character in A-reg, with 
Carry set, BR to routine for 
Escape key service. 

@ HOME clear scroll window 

A ADVANCE cursor right 

B BS cursor left 

C LF cursor down one line 

D UP cursor up one line 

E CLREOL clear to end of line 

F CLREOP clr to end of window 

other ignore: RTS 

Set po rt C (keyboard) for input. FE89 65161 -375 SETKBD A,X,Y 



get next character FD35. 64821 -715 RDCHAR A,Y 



FD0C 64780 -756 RDKEY A,Y 

FD18 6A792 -744 A 

FD1B 64795 -741 KEYIN A 

FD26 64806 -730 

FD28 64808 -728 A 



FC2C 64556 -980 ESC] 



OLD MONITOR ONLY 

Call RDKEY for Escape key service & FD2F 64815 -721 ESC 

Call ESC1 with character in A-reg FD32 64818 -718 

and Carry set to do indicated 

function. Return is to RDCHAR. 



AUTOSTART MONITOR ONLY 

Call RDKEY for Escape key service & FD2F 64815 -721 ESC 

Call ESCNEW with character in A-reg FD32 64818 -718 

and Carry set to do indicated 

function. Return from Escape 

processing is to RDCHAR (above). 



A,Y 



A.Y 
A.Y 



A,Y 
A.Y 



3D 
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FuncC ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Set Carry flag and JMP to ESC1 
to handle Escape key functions 
A, B, C, I), E, F. 

Handle Escape key functions 
I, J, K, M. Translate to 
D, B, A, C and call ESCOLD. 
Then RDKEY to get next character 
and drop into ESCNEW to continue 
Escape key processing. 

Escape key processing entry point. 
If A-reg contains I, J, K, or M 
then go to ESCNOV to translate 
and handle it with return to 
ESCNEW. Otherwise go to ESCOLD 
to handle this entry and exit 
from Escape mode. 



FB97 64407 -1129 ESCOLD 



FB9B 64411 -1125 ESCNOW 



A.Y 



A,Y 



FBA5 64421 -1115 ESCNEW 



A,Y 



RASL.H 40-41 $28-$29 

KSWL, 11 56-57 $38-S39 

ADDRESS TABLE 2-LINE INPUT 

Logically speaking, the place to start below is CETLNZ, but the 
sequence of presentation here is the sequence of instructions in the 
Monitor because of heavy use of "fall into" next code segment. 

Note that once the Monitor is jumped to at the specified point, all of 
the initialization described after that entry point is also performed. 
This is implied by the & at the end of each function description- 



function 



Hex +Dec -Dec. Monitor Registers 
Addr Addr Addr Label Destroyed 



Echo keyboard input thru COUT to 

the screen, from 1N,X, with 

INVKLG temporarily set to $FF. 
Pick up character from IN,X; 

if $88 goto BCKSPC. 

if $98 goto CANCEL. 

if X-reg (input index) greater 
than $F7 fall into FD5C. 

Else goto NOTCR1, bypass Bell. 
Sound bell if X indicates 248+ 

Input characters. 
Increment X-reg; 

If X not zero goto NXTCHAR. 

If X=0 fall into CANCEL. 



FD3D 64829 -707 NOTCR 



FD4D 64845 -691 



FD5C 



FD5F 



64860 
64863 



-676 

-673 NOTCR 1 
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Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Load $DC (\) into A-reg. 

Backward slash indicates line 

input cancelled. 
Call COIIT to print A-reg. 

Then fall into CETLNZ. 
Print carriage return thru COUT. 
Load PROMPT into A-reg. 
Call COUT to print A-reg. 
Load X-reg with $01 For passage 

thru backspace operation. 
If X=0 goto GETLNz to start over. 

Else, decrement X— reg and 

fall into NXTCHAR. 
Call RDCHAR to get next character. 

If character received is ctrl-U 

($95, right arrow) pick up the 

screen character from (BASl.).Y 

to replace it in the A-reg. 
If A-reg greater than $DF, then 

AND against $DF to make it 
vipper case. 
Store A-reg to input area at IN,X. 
Compare to carriage return. 

Goto NOTCR (above) if not. 

Else, call CLREOL to clear the 

rest of the line, then print 
carriage return thru COUT, 
using RTS from that function to 
accomplish return to caller of 
keyboard input. 



FD62 64866 -670 CANCEL A,X,Y 



FD64 64868 -668 



& 

& FD67 


64871 


-665 


CETLNZ 


A,X,Y 


& FD6A 


64874 


-662 


GETLN 


A,X,Y 


C FD6C 


64876 


-660 






FD6P 


64879 


-657 




A,X 



FD71 64881 -655 8CKSPC A,X,Y 



FD75 64885 -651 NXTCHAR A 



& 



FD7E 64894 -642 CAPTST ?A 



FD84 64900 -636 ADDINP 



IN =$0200, keyboard input area. 

INVFLG is at $32 (50). 



OVERVIEW—TEXT OUTPUT TO THE SCREEN 

The highest level of support in the Monitor for text output to the 
screen is scroll device support. In addition, the Monitor contains 
many components which support use of the screen in a formatted manner. 
Because there ore so many ways to write text to the screen, the topic 
of screen output has been divided into the following sections: 

TEXT OUTPUT WITHIN TIE SCROLL WINDOW 

describes the normal manner of text output, defining the fields in 

page zero which are used to control this function, and which are 
used in the descriptions in the following sections. 
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SCREEN FORMAT CONTROL 

identifies the entry points by means of which display operation 
(full text, full graphics, mixed LORES graphics and text), Scroll 
Window setup, and character display mode (black on white or white 
on black or blinking) are established or modified. 

SCROLL WINDOW DATA MANIPULATIONS 

describes Monitor calls which clear all or part of the Scroll 
Window, set parts of the window to some user specified value, or 
cause conditional or unconditional scrolling of the window. 

CURSOR POSITION CONTROL 

describes the ways and means of moving the cursor relative to its 
current position, or moving it to some location independent of its 
current position. 

GENERAL TEXT TO THE SCREEN 

describes the Monitor entry points to output user program 
generated data to the screen or to the current output device if 

CSWL- has been modified. Also, entry points are described to 
transmit standard types of output (blanks, bell code, carriage 
return) to the output device (generally screen). 

TEXT OUTPUT WITHOUT THE SCROLL WINDOW 

describes the entry points used for placing characters on the 
screen outside of the Scroll Window, and for reading the keyboard 
when echo to the Scroll Window is to be performed. 

SECONDARY DISPLAY AREAS 

describes various ways of using the Secondary Text area, even for 
limited Scroll Window functions such as allowing keyboard input 
echo to go to the Secondary area. 

Any entry point which fits into more than one category will be found 
in each appropriate address table. 



OUTPUT WITHIN THE SCROLL WINDOW 

Scroll Window operation is compatible with printer or typewriter 
output in that new characters are displayed to the right of previous 
output, and new lines are displayed below previous lines. It is this 
mode of operation which is described in this section. That is, this 
section describes "printing" information by means of the CSWL vector 
to the screen or to a printer type device. The section on General Text 
to the Screen describes use of the screen, bypassing the CSWL vector 
and making direct use of the Scroll Window output routines. 

The normal method provided in the Apple II for displaying output 
information is by "calling" COUT with the character in the A-reg for 
each displayable character or format control character (such as a 
carriage return). At COUT, a JuMP Indirect is done via the CSWL vector 
to the routine which will place the character on the selected medium 
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or accomplish the indicated control function. When the system is 
initialized, this vector is set to point to C0IIT1 which supports 
Scroll Window output to the screen. If the user sets a different 
output device (hy PR//n in BASIC or ctrl-P in Monitor mode), then Che 
CSWL vector will be set to pass the output bytes to the selected 
peripheral controller card instead of to the screen. Depending on 
which peripheral controller card, and which controls are active, the 
program on that card may place the character on the output device, and 
then JuMP to C011T1 to write It also to the Scroll Window. 

The normal mode of text output to the screen is in "scroll" mode. In 
this mode, new information is written to the bottom line of the 

screen, and the contents of the screen are moved up, up, and away as 
required to allow entry of new information below the old. This mode of 

output is used in APPLESOFT or BASIC "PRINT" statements. This is the 

mode of output used by any Monitor command which displays data to the 
screen. 

As new characters are written to the screen, they are placed at the 
position of the cursor. The cursor position Is a location on the 
screen (and in screen refresh memory) specified by the contents of 
certain fields in page zero. Also, the Scroll Window is a portion (or 
all) of the screen as defined by the contents of certain fields in 
page zero. There is no special display hardware involved with the 
scrolling function. Routines in the Monitor move data in the screen 
refresh memory as required to support the scrolling function. 

The. fields in page zero describing the Scroll Window indicate the left 
column and width, and the top and bottom lines, as described here. 

The cursor position is defined in various fields, and unless a user 
program interferes they will be compatible. 

The screen line number of cursor position is contained in the field 
CV. CV indicates the line number of the cursor relative to the top 
line of the screen, not the Scroll Window. (Note that this is 
different from CH, described below.) The screen refresh memory 
location which corresponds to this line number is maintained in the 
two byte field (BASL.H). Note, however, that if the left edge of the 
Scroll Window is not the leftmost character of the screen, BASL.H will 
have been adjusted to point to the leftmost character position on that 
line within the Scroll Window. Thus, a program may interrogate CV to 
determine the line number of the cursor, but the program cannot just 
POKE a different line number into CV to move the cursor as BASL.H must 
be updated as well. 

The horizontal, position of the cursor is maintained in CH. The value in 
CH is relative to the left edge of the Scroll Window, not necessarily 
to the screen. When a character is being "written" or "printed" to the 
screen, the routine which places the character in screen refresh memory 
uses the Y-reg for horizontal position, in the assumption that it has 
been loaded from CH. In the address table, each description indicates 
whether the routine being called uses CH or the Y-reg. 
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For machine language programs, Scroll Window output is most easily 
accomplished by a JSR to COUT at $FDED (-531) with the byte in the A- 
reg. From BASIC the same thing is accomplished by PRINTing a variable 
in which the byte has been stored. In BASIC, of course, a whole string 
can be written with a single command. 

As the characters are passed through C0UT1, they are modified, If 
necessary, to be written in white on black, black on white, or 
flashing, in accordance with the contents of the field called INVFLG. 
This field can be set (POKEd) at any time, and is immediately 
effective on all future characters printed by the program until it is 
again modified. This function only applies to program print output. 
During keyboard entry, INVFLG is temporarily changed to $FF as each 
input character is echoed through COUT. 

The two byte field BAS2L.H is described below although it is rather 
useless for user program reference. It is a work area used only 
during a scroll operation. 

PAGE ZERO FIELDS 

Dec Hex Routine Description 

32 $20 WNDLFT Left column of the Scroll Window: 
Range is to 39 ($27). 

This field is used only in VTABZ. The contents, 
when changed by user program, become effective on 
the next scroll operation, clear to end of page 
operation, or carriage return output. CH contains 
cursor horizontal position relative to (WNDLFT). 

After changing the contents of WNDLFT, either CALL 
VTAB or output a carriage return to make it take 
effect. 



33 $21 WNDWDTH 



34 $22 



Width of the Scroll Window: 

Range is 1 to 40-(WNDLFT). 

When a character is written through COUT to the 

screen it is placed at (BASL).(CH), after which CH 

is incremented. At that time (CH) is compared with 

(WNDWDTH) to determine whether the cursor has 

exceeded the right margin of the Scroll Window. 



WNDTOP Top line of the Scroll Window: 

Range is to 22 ($16) for full text screen. 
Range is 20 to 22 ($14 to $16) for mixed graphics 
and text. This field is used during a scroll 
operation to indicate where the operation should 
start. 
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Dec Hex Routin e Description 

35 $23 WNDBTM Bottom line of Scroll Window +1 : 
Range is (WNDT0P)+1 to 24 ($18). 

WNDBTM indicates the first line number below the 
window. Contents of WNDBTM are tested only on 
output of a carriage return ($8D) or line feed 
($8A). It is used by Clear to End of Page and by 
Scroll routines. 



36 $24 CH 



Displacement from WNDLFT where next character to 
the screen will bo placed: 
Range is to (WNDWDTH)-l. 

After the screen output routine STOADV places a 
character into the screen area as part of normal 
character output, CH is then incremented and 
compared to WNDWDTH. If CH is not low then a 
carriage return will be simulated. 

Note that CH is used for echoing keyboard input to 
the screen by the Monitor routines GETLN etc., 
because COUT is used. 



37 $25 CV Vertical screen position (line number) for next 

character to be written to the screen: 
Range is to 23 ($17). 

The content of CV is relative to the top of the 
screen, not to the top of the Scroll Window. It 
may be set by loading the desired line number into 
A-reg and calling TABV. It may be set by POKEing 
the line number into CV and then calling VTAB. 
Actual storage of a character into the screen area 
includes use of BASL, II for line number, not CV. 
The calls above to VTAB or TABV are to set BASL.H 
from CV for immediate future reference. 

If CV is at or below WNDBTM, It will remain on 
current line as carriage returns go by while the 

contents of the Scroll Window trill be scrolled for 
each. 

40 $28 BASL This two byte field is the memory address for the 

41 $29 BASH left end character position of the current text 

line, within the Scroll Window. The contents are a 
function of CV and WNDLFT. 

This field is set by the BASCALC routine to point 
to the memory address for the left end of the line 
specified in the A-reg. This call to BASCALC is 
usually accomplished by the VTAB routine, which 
then adds (WNDLFT) to BASL, 11 to point to the left 
end of the line within the window. 
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Dec Hex Routine Descripti on 



42 
43 



50 



$2A BAS2L This two byte field is used as a work area only 

$2B BAS2H during a scroll operation. It is the destination 

line pointer used as each line is moved to the 

position above current. 



$32 INVFLG 



53 $35 YSAV1 



This byte is a mask used by C0UT1 to cause 
characters written to the screen area to display 
white on black (INVFLG=$FF) or black on white 
(INVFLC=$3F) or flashing (IHVFLG=$7F). This field 
is set to $FF when a RESET occurs by the routine 
at SETNORM. The routine called SETIKV can be 
called to set reverse video. The Monitor does not 
set flashing. 

Note: INVFLG=$7F does not cause all characters to 
flash: the upper Z bits of the character must be 
01 for flashing to occur. 

Tills byte is a save area for the Y-reg across a 
call to the screen output routines. Y-reg is saved 
and restored in the C0UT1 routine. 



54 $36 CSWL This two byte field contains the address of the 

55 $37 CSHW routine which is to receive and dispose of output 

characters. When the RESET key is pressed, this 
field is initialized to point to C0UT1 to send 

output characters to the screen. Entering a 
Monitor Command nPc (n=port number, Pc=control-P) 
will cause the Monitor to set CSWL.H to Cn00. The 
routine at that location will then receive (in the 
A-reg) each byte "written" through COUT, which is 
a JMP (CSWL). 

If the Monitor Command "0Pc" is executed, CSWL, 11 
is set to point to C0UT1 instead of to C0M. 



SCROLL WINDOW OUTPUT ROUTINES 



Funct i on 



Ilex -H)ec. 
Addr Addr 



-Dec Monitor Registers 
Addr Label Destroyed 



.lump via CSWTT, character print. 
Write byte in A-reg to screen at 

cursor (CV),(CH) using INVFLG and 

supporting cursor move. 
Write byte in A-reg to screen at 

(CV),(CI1) with cursor move but 

not INVFLG. 



FDED 
FDF0 



65005 =5TT 
65008 -528 



COUT 
C0UT1 



none 
none 



FPF6 65(314 -522 COUTZ none 



KEYBOARD INPUT AND SCREEN OUTPUT 33 



Function 



Hex +Doc -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Print carriage return thru COliT. FD8F, 

Print thru COUT "ERR" and bell code.FF2D 

Print bell code ($87) thru COUT. FF3A 

Set BASL.H from CV (and WNDLFT). 
Set BASL.H from (A) and WNDLFT 

without regard to CV. 
Set BASL,H to left end of screen 

line (not window line) in A-reg. 



FC22 
FC24 



64910 
65325 

653M 
64546 
64548 



^6TE~ 
-211 

-198 
-990 
-988 



CROUT 
PRF.RR 

BF.LI. 
VTAB 
VTABZ 



A 
A 

A 
A 
A 



FBC1 64449 -1087 BASCALC A 



CH 


36 $24 


CV 


37 $25 


G BASL.H 


38-39 $26-27 


BASL.H 


40-41 $28-29 


INVFLG 


50 $32 



WNDLFT 32 $20 

WNDWDTH 33 $21 

WNDTOP 34 $22 

WNDBTM 35 $23 



SCREEN FORMAT CONTROL BY ROUTINE 

This table identifies the places in the Monitor which control the 
display mode of operation and the Scroll Window configuration. 



Function 



Hex -Wee -Dec Monitor Registers 

Addr Addr Addr Label Destroyed 



Clear HIRES graphics mode. 
Set display area primary. 
Set TEXT node. 

Load into A-reg for WNDTOP, 
branch to SETWND below. 

Set Graphics mode. 
Set mixed graphics /text mode. 
Call CLRTOP to clear graphics. 
Load 20 ($14) into A-reg for set 
of WNDTOP. Fall into SETWND. 



& FB33 64307 -1229 A 

& FB36 64310 -1226 A 

& FI539 64313 -1223 SETTXT A 

& FB3C 64316 -1220 A 



& FB40 


64320 


-1216 SETGR 


A.Y 


& FB43 


64323 


-1213 


A.Y 


& FB46 


64326 


-1210 


A,Y 


& FB49 


64329 


-1207 


A 



Set top line of window (WNDTOP) FB4B 64331 -1205 SETWND A 



from A-reg, or 20 or user set 

Fall thru following. 
Load A-reg with tor WNDLFT. 
Store A-reg to WNDLFT. 
Load A-reg with 40 for WNDWDTH. 
Store A-reg to WNDWDTH. 
Load A-reg with 24 for WNDBTM. 
Store A-reg to WNDBTM. 
Load A-reg with 23 for VTAB. 
Store A-reg to CV. 
Jump to VTAB - set BASL.H RTS . 
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& FB4D 64333 -1203 A 

& FB4F 64335 -1201 A 

5 FB51 64337 -1199 A 

6 FB53 64339 -1197 A 
& FB55 64341 -1195 A 

5 FB57 64343 -1193 A 

6 FB59 64345 -1191 A 
& FB5B 64347 -1189 TARV A 



i- m 

fc m 

h- • 

fc - 

fc * 

fc I 

fc I 

I- • 

H • 

I- - 

fc - 

H - 

I- * 

fc - 

fc I 

h - 

fc * 

fc m 

fc m 

fc * 

fc - 

h m 



I'unct ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Load Y-reg-'wlth $Ft' for INWlC. FkTTC 55T56' -W SCTMokM 7 

Fall into SETIFLG. 
Load Y-reg with S3F for INVFLG. FE80 65152 -384 SETINV Y 

BR to SETIFLG. 

Store Y-reg in INVFLG and RTS. FE86 65158 -378 SETIFLG none 

$FF white on black (from SETNORM) 
$3F black on white (from SETINV) 
$7K flashing (characters from user call with upper 2 bits of 01) 



Set CSWL.II to point to COUT1. 



FE93 65171 -365 SETVID A,X,Y 



CH 36 $24 

r:v 37 $25 

INVKl.G 50 $32 

BASE, I) 40-41 $28-29 

CSWL.II 54-55 $36-37 



WNDLFT 32 

WNDWDTH 33 

WNDTOP 34 

WNDBTM 35 



$20 
$21 
$22 
$23 



SCREEN FORMAT CONTROL 
BY POKE/STORE 



In many cases, the routine in the Monitor described on the previous 
page exists because the Monitor itself uses the function described. 
Often, calling the Monitor for a specific control function is doing it 
the hard way. This table indicates other ways of accompJ ishing the 
same results. 



Function 



Method 



Set GRAPHICS display mode. 

Set TEXT display mode. 

Set GRAPHICS mode to full screen. 

Set MIXED GRAPHICS and TEXT mode. 

Set display to Primary Area. 

Set display to Secondary Area. 

Clear HIRES /Set LORES for graphics. 

Set HIRES Graphics mode. 

Set top line of Scroll Window. 

Set left edfte of Scroll Window. 

Set width of Scroll Window. 

Sot bottom line of Scroll Window. 

Set Norma] (white on black) text. 

Sot Flashings text. 

Sot Inverse (black on white) text. 



POKE 


-16304,0 


or 


STA 


C050 


POKE 


-16303,0 


or 


STA 


C051 


POKE 


-16302,0 


or 


STA 


C052 


POKE 


-16301,0 


or 


STA 


C053 


POKE 


-16300,0 


or 


STA 


C054 


POKE 


-16299,0 


or 


STA 


C055 


POKE 


-16298,0 


or 


STA 


C056 


POKE 


-16297,0 


or 


STA 


C0S7 



POKE 34, line-number (0-23) 
Bottom must be greater than top. 
POKE 32, column-number (0-39) 
Left edge + width not to exceed 40. 
POKE 33 ,number-of-columns (1-40), 
Left edge + width not to exceed 40. 
POKE 35, line-number (i-24) 
Bottom must be greater than top. 
POKE 50,255 or store. $FF in $32 
POKE 50,127 or store $7F in $32 
POKE 50,63 or store $3F in $32 
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If the above means are used to change the Scroll Window conf iguratioit , 
the user program should also take steps to insure that the cursor has 
a valid position within the window (CV, CH, BASL.H). CALL -936 will 
place the cursor in the Window. 

$C050 and $C051 control Text mode vs. all or some graphics. The other 
items regarding HIRES or LORES or full or part screen graphics may he 
established first, but will not be apparent until $C050 is tickled. 
Likewise, $C051 will bring back Text Mode regardless of the other 
settings. 

SCROLL WINDOW DATA MANIPULATIONS 

This table describes three types of Scroll Window data manipulation 
entry points. The first is Monitor label RSC1, the Escape Key 
Processor, because it transfers control to a nuraber of the other entry 
points depending upon the A-reg contents and Carry being set. One 
entry point of the Autostart Monitor is included because it handles 
one requirement of ESC1 - that Carry be set. 

The second part of the table is a list of entry points supporting 
clearing or setting parts of the screen to a particular value. 

The third part of the table describes points causing conditional or 
unconditional scrolling of the window. 



ADDRESS TABLE 



Function 


Ilex 


+l)ec 


-Dec 






Addr 


Addr 


Addr 


Call 


screen 


data manipulation. FC2C 


64556 


-980 


If Carrv i 


? set and A-reg = 






P 


goto 


HOME 






A 


goto 


AnVANCF. 






B 


goto 


BS 






C 


goto 


LF 






D 


goto 


111' 






E 


goto 


CLREOL 






F 


goto 


CLRF.OP 






other 


RTS to caller. 






The 


RTS at 


the end of each of 






these functions returns control 






to 


the ca 


Her of ESC1. 







Monitor Registers 
Label Destroyed 



ESC1 



A,Y 



3D 



Funct i on 



■3D 



■■ 



f" 



fc 
fc 



Clear from line (CV) col (CH) to 

end of Scroll Window. 
Clear from line (CV) col (Y) to 

end of Scroll Window. 
Clear from line (A) col (Y) to 

end of Scroll Window. 
Clear Scroll Window to blanks, 

set cursor to top left corner 

of the window. 
Set CMS, CV=(A), clear to EOF 

(end of page = end of window). 
Clear window from line (A) to 

blank, set cursor to left end of 

I ine (CV). 
Clear line from cursor 

(<BASI.),(CH)). 
Clear line from cursor (BASL),Y. 
Set character in A-reg from 

cursor (BASL),Y to EOLine. 
Clear line (BASL), then set 

BASL.H from CV and WNDLFT. 
Clear line from cursor (BASL),Y, 

then set BASL, II from CV & WNDLFT. 

Cli remains unchanged. 

Zero to A-reg for CH. 

Store A-reg to CH. 
Im-renent CV. 
Compare CV to WNDBTM. 

Set BASL, II; if (CV) < (WNDBTM), 

ilo scroll if required. 

Si-rnll the window, lines (CV) 

thru (WNDBTM). 
Scroll the window, lines 

(A) through (WNDBTM). 



Auto start Monitor extended service 

Set Carry flag and JMP to ESC1 
i<> handle F.scape key functions 
A, B, C, D, E, F. 



Hex 


+Dec 


-Dec 


Monitor 


Regis 


Addr 


Addr 


Addr 


Label 


Destr 


FC42 


64 578 


-958 


CLREOP 


A,Y 


FC44 


64580 


-956 




A,Y 


FC46 


64582 


-954 


CI.EOP1 


A,Y 


FC58 


64600 


-936 


HOME 


A,Y 


FC5A 


64602 


-934 




A,Y 


FC5C 


64604 


-932 




A.Y 


FC9C 


64668 


-868 


CLREOL 


A.Y 


FC9E 


64670 


-866 


CI.F.OLZ 


A,Y 


FCA0 


64672 


-864 


CLEOL2 


A,Y 


FC95 


64661 


-875 


SCRL3 


A,Y 


FC97 


64663 


-873 




A.Y 



& FC62 


64610 


-926 CR 


A,?Y 


& FC64 

& FC66 

FC68 


64612 
64614 
64616 


-924 

-922 LF 
-920 


A,?Y 
A,?Y 
A,?Y 



FC70 64624 
FC72 64626 



-912 SCROLL 
-910 



Cll 


36 


$24 


CV 


37 


$25 


INVFl.C 


50 


$32 


IIASl.,11 


40-4 1 


$28-29 



A,Y 
A,Y 



FB97 64407 -1129 KSCOLD A,Y 
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WNDLFT 32- $20 

WNDWDTH 33 $2 1 

WNDTOP 34 $22 

WNDBTM 35 $23 
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CURSOR POSITION CONTROL 

In general, the Cursor is at the position indicated by the contents of 
CV (line number relative to top of screen) and CH (column number 
relative to to the left margin of the Scroll Window). The memory 
location of the cursor is the sum of the contents of BASL.H (which 
contains the address of the leftmost character of the line within the 
Scroll Window) and the contents of CH. Normally, then, BASL,H contains 
an address computed from the contents of CV and WNDLFT. However, if 
either CV or WNDLFT is changed without recomputing BASL.H then the 
different routines of the Monitor may come up with unpredictable (or 
at least undesired) results. 

In the following table, the description includes indication of which 
of the cursor address fields is being used for what. Note, for 
example, that at $FC95 the line indicated by BASL.H Is cleared, and 
then BASL.H is recomputed from CV, WNDLFT for futiire references. 

The ESC1 and VTDOUT routines are included in the table because they 
can be made to use (goto) the other entry points by passing them the 
appropriate A-reg contents on entry. VIDOHT is the routine which 
handles CR, backspace, and line feed when such characters are sent 
through C0UT1 (generally thru COUT). F.SC1 is the routine called to 
accomplish the desired function when the keyboard routines are 
operating in ESCAPE key mode. Thus, it has four way cursor movement 
capability, as well as the capability of clearing the Scroll Window 
from cursor present position to end of current line or end of the 
Scrol] Window, or of clearing the entire Scroll Window and placing the 
cursor at the top left corner of it. The function performed depends 
upon the contents of the A-reg at entry, and the. "set" condition of 
the Carry processor status bit. 

Entry point ESCOLD of the Autostart Monitor is included in the table 
due to its relationship to ESC1. 

The next group of points contains those which clear data on the screen 
as well as move the cursor. 

The third group is entry points supporting movement of the cursor 
relative to its current position. 

The fourth group supports positioning the cursor at a desired location 
without reference to its current position. To do this, the program 

should set CV and CH and then call VTAB to set BASL.H. 
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ADDRESS TABLE 



Fund ion 



Hex +Dec -Dec Monitor Registers 
AdHr Addr Addr Label Destroyed 



A 


fiOtO 


li 


goto 


C 


goto 


h 


goto 


K 


goto 


F 


goto 



Cull screen/cursor manipulation. 
IT Carry Is set and A-reg = 
P goto HOME 

ADVANCE 
BS 
LF 
UP 

CLREOL 
CLREOP 
other RTS to caller. 

The RTS at the end of each of 
these functions returns control 
to the caller of ESC1. 
Sot Carry flag and JMP to ESC1 
I" handle Escape key functions 

A, li, C, D, E, P. 

Place character in screen memory 

in- process control character. 

If (A) > S9F or < $80 goto STOADV. 

If (A) = $8D goto CR. 

II" (A) = $8A goto LF. 

If (A) = $88 goto BS. 

II (A) = $87 sound "bell". 

If (A) - other ignore it; RTS 

Clear Scroll Window, set cursor to 

top left corner of the window. 
SVl CII-0, CV=(A), clear to EOP 

(end of page = end of window). 
Clear window from line (A) to 

hi. ink, set cursor to left end of 

I I lit- (CV). 
Clear line (BASL), then set 

II A SI., II from CV and WKDLFT. 
Clear line from cursor (BASL),Y, 

I lion set BASL.H from CV & WNDLFT. 



Load Y I rom CH. & FBF0 

Store A-1-...1; to screen at (BASL),Y & FBI'2 



FC2C 64556 -980 ESC1 



A,Y 



FB97 64407 -1129 ESCOLD A,Y 
Autostart only 

FBFD 64509 -1027 VIDOHT A,Y 



FC58 


64600 


-936 


FC5A 


64602 


-934 


FC5C 


64604 


-932 


FC95 


64661 


-875 


FC97 


64663 


-873 



I nr rement CM . 

Compare (CH) with (WNDWDTH) 

goto CR I I Cll not less. 

Hlim return (RTS). 
Hove cursor loft one column, to 

rlf.hi end of previous line if 

required and (CV) < (UNDTOP). 



& FBF4 
& FBF6 



HOME 



SCR], 3 



64496 
64498 
64500 
64502 



-1040 
-1038 
-1036 
-1034 



STOADV 
ADVANCE 



A,Y 
A.Y 
A,Y 

A,Y 
A.Y 



A,Y 

A 
A 
A 



FC10 64528 -1008 BS 
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Function 



Move cursor up one line 

if (CV) < (WNDTOP). 
Zero to A-reg for CH. 
Store A-reg to CH. 
Increment CV. 
Compare CV to WNDBTM. 

If CV not less decrement CV and 
do scroll. 

If CV less goto VTABZ Co set 
BASL,H and return. 

Place cursor at line (A) col (CH) 
(store A to CV and set BASL,H 
by JMP to VTAR). 

Set BASI.,11 from CV and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL.II from A-reg and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL.H to memory address for 
left character of line in A-reg 
(not left character of window). 

Jump via CSWL, character print. 
Character print to screen output 

routine entry - normal for CSWL. 

Print character to screen with 

appropriate actions on controls 

and control characters. 

If (A)<$A0 goto COUTZ, bypass 
inverse video mask. 





Hex 


+Dec 


-Dec 




Addr 


Addr 


Addr 




FC1A 


64538 


-998 


& 


FC62 


64610 


-926 


& 


FC64 


64612 


-924 


& 


FC66 


64614 


-922 




FC68 


'64616 


-920 



-Dec Monitor Registers 
Label Destroyed 



UP 



CR 



LF 



A,?Y 
A,?Y 
A,?Y 
A,?Y 



FB5B 64347 -1189 TABV 



FC22 



FC24 



64546 
64548 



-990 VTAB 



FBC1 64449 -1( 



VTABZ 



BASCALC A 



FDED 65005 -531 COUT ?A 

FDF0 65008 -528 COUT1 ?A 



AUTOSTART MONITOR ONLY 

Print character to screen via FDF6 

VIDWAIT (pause If operator request) 

and VIDOUT with save and restore 

of A reg and Y reg. 



J14 -522 



COUTZ 



OLD MONITOR ONLY 

Print character to screen via 

VIDOUT with save and restore 

of A reg and Y reg. 



FDF6 65014 -522 COUTZ 



CH 


36 


$24 


CV 


37 


$25 


INVFLG 


50 


$32 


BASL.H 


40-41 


$28-29 



WNDLFT 32 $20 

WNDWDTH 33 $21 

WNDTOP 34 $22 

WNDBTM 35 $23 



i 



i 

c 



P 
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GE NERAL TEXT TO THE SCREEN 

The preferred method of sending text to the screen is by loading the 
character desired into the A-reg and calling COUT to handle it from 
l here. The reason this is preferred is that if you want to send the 

output to some device other than the screen, you can change CSWL.H 
l<> point at the program supporting such other device. There are 
time.':, however, when you'll want to write to the screen regardless of 
the setting of CSWL.H. C0UT1 is the entry point for screen-only 
output, where reverse video display or flashing characters are set 
uK lug INVFLG. Entry at this point for the Autostart Monitor also 
allows you to stop output, using the control-S key. 

COUTZ may be used for output to the screen without modifying the 
character by using INVFLG. That is, calling COUTZ with a character In 
the A-reg will place that character on the screen as Is, without using 
INVFLG to display the character in inverse video or flashing mode. In 
t lie Autostart Monitor, entry at COUTZ is still early enough to handle 
control-S entry, stopping the system if the character being written is 
a Carriage Return while the keyboard buffer contains a control-S. 

VIDOUT is the routine which interprets the character and places it on 
the screen if it is not a control character. If the VIDOUT routine is 
to bo called directly (to bypass control-S handling in the Autostart 
Monitor, for example), then the calling program must save the A-reg 
and Y-reg before and restore the A-reg and Y-reg after, because they 
are both destroyed in the VIDOUT routine. 

Output to the screen may be written via these alternate entry points. 
However, note that the Monitor will still use COUT for the keyboard 
Input echo function, temporarily setting INVFLG to $FF for white on 
black for each character echoed. 

Following are addresses of the above mentioned locations, and a few 
other entry points which will output the specified character(s) (via 
COUT) without the calling program having to load them into the A-reg 
hi'fore the call. 



ADDRESS TABLE 



l-'unct Ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Print a byte to specified output 

device by JMP (CSWL), normally 

COISTI for screen. 
Character print to screen output 

routine entry - normal for CSWL. 

Print character to screen with 

appropriate actions on controls 

and control characters. 

II (A)<$A0 goto COUTZ, bypass 
Inverse video mask. 
AND (A) with INVFLG. 



FDED 65005 -531 COUT 



FDF0 65008 -528 C0UT1 



& FDF4 65012 -524 



?A 
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Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Print a byte to the screen. 

See AUTOSTART and OLD differences 

toward end of this table. 
Process char, in A-reg to screen. 

If control character, do control. 

If display character, store in 
screen refresh memory. 
Store A-reg to screen at 

(BASL,H),(CH), then increment 

CII and goto CR if window exceeded. 
Store A-reg to screen at (BASL,H),Y 

then inc CII and goto OR if window 

exceeded . 
Increment CI! and goto CR if window 

exceeded. 
Test CII. Ooro CR if CM => HNDWDTH. 
Tf A=S8D, S8A, $88, or $87 do it: 

$8D carriage return goto CR 

$8A line feed goto LF 

$88 back space goto RS 

$87 be! 1 sound "bell" 

Set INVFLC to $3F = inverse video. 
Set INVFLC to $FF = normal video. 
Set INVFLC from Y-reg. 



FDF6 65074 =522 C0VT7. none 

FBFD 64509 -1027 VIDOUT A,Y 

FBF0 64496 — 1 (^^0 STOADV A,Y 

FRF2 64498 -1038 A 

FBF4 64500 -1036 ADVANCE A 



FRF6 
FC04 



FF80 
FES A 
FF.86 



64502 
64516 



65152 
65156 
65158 



-1034 
-1020 



-384 SETIMV Y 
-380 SF.TNORM Y 
-378 SETIFLC none 



AUTOSTART MONITOR ONLY 
Print character to screen via 
VIDWAIT (stop if operator remtest) 
and VIDOUT with save and restore 
of A and Y regs. 
Test for operator pause reouest. 
If (A) = S8D (carriage return), and 
if keyboard register is full, and 
if keyboard reg contains cntl-S, 

then fall Into KBOUAIT. 
Else, goto VIDOUT. 
Pause system per operator request. 
Loop until new key pressed. 
If next key pressed is cntl-C 

then goto VIDOUT, leaving cntl-C 

in keyboard register. 
Else, clear keyboard strobe and 

goto VIDOUT. 



FDF6 65014 -522 C0UT7. 



FR78 64376 -1160 VIDWAIT Y 



FR8fi 64392 -1144 KROWAIT Y 



OLD MOM I TOR ONLY 

Print character to screen via 

VIDOUT with save and restore of 

A- reg and Y-reg. 



FDF6 65014 -522 COLT/: 



OH 


36 


$24 


mini -FT 


32 


$20 


cv 


37 


$2 5 


WNDWDTH 


33 


$21 


INVFLC. 


50 


$32 


WKDTOP 


34 


$22 


RASI.,II 


40-41 


$28-29 


WMDBTM 


35 


$2 3 



i 
E 
► 
E 
E 
E 
E 
E 
E 
E 
E 
fc 
E 

► 
E 
E 
fc 
fc 
fc 



ff 



CONTROL CHARACTERS 

Note: 

The following control characters have special meanings for screen 

<l I spl ay . 

Sfiil Carriage Return 

In the Autostart Monitor, the COUTZ routine calls (JSR) VIDWAIT, 
which handles the control-S function before jumping to VIDOUT. 
The COUTZ routine in the Old Monitor calls VIDOUT. 

When the VIDWAIT routine determines that the character beinp, 
"written" is a Carriage Return, it then tests the keyboard input 
buffer for a control-S. If so, it clears the keyboard hardware for 
another entry and loops until another key is pressed. If this 
entry is other than a control— n, the keyboard strobe is cleared. 
Otherwise the keyboard is left filled with the control-C for the 
calling program to detect and handle. Then VIDWAIT JMP's to 
VIDOUT. 

$8A Line Feed 

The cursor is moved down one line unless this would put it on a 
line below the Scroll Window. In that case, the contents of the 
Scroll Window are moved up one line, and the cursor stays on the 
current screen line. 

$8H Backspace 

The VIDOUT routine moves the cursor to the left one space by 
decrementing CH. If CH goes negative It is set to (WNDWDTH)-l and 
CV is decremented. If decrementing CV would take it above (WNDTOP) 
CV is not decremented. Negative scroll is not supported. 



$H? Sound the Bell 

The speaker is pulsed 1000 times per second for one tenth of a 

second • 

Anv other character in the range $80 thru $9F is dropped. It does 
not cause cursor motion or memory modification. 

OUTPUT WITHOUT THE SCROLL WINDOW 

II nil or part of the screen is to be used in a direct addressing 
iimuner, It is necessary to avoid certain Monitor services. In general, 
l he Scroll Window services provided by the Monitor are: 

I. Scroll all text in the window up one line if a carriage return 
or line Iced takes the cursor down through the bottom line of 
l he wl ikIow. 

'.' . Automatically assume carriage return if window width is 
exceeded • 
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3. Place the cursor at the left edge of the Scroll Window Instead 
of at the left edge of the screen on a carriage return. 

4. Support screen clear functions: 

A. Clear the window, place cursor at top left corner. 

B. Clear the window from current cursor position. 

C. Clear line to the right of cursor position. 

When using all or part of the screen as a random access display, those 
automatic services need be avoided. 

If the full screen is to be used as a random access display, without a 
portion being used as a working Scroll Window, the problem is not too 
difficult. Consider leaving the whole screen defined as the Scroll 
Window. 

1. The scroll operation only occurs if a carriage return or line 
feed or exceeding window width occurs on the !x>ttOm line of the 
Scroll Window. Avoid this by not having the program output CR or 
LF or excessive data on the bottom line of the screen, and by 
keeping the cursor away from the bottom line of the screen 
during keyboard input operations. 

2. The full screen is defined as the Scroll Window by the Monitor 
when the RESET key is pressed. A user program can restore the 
window parameters to this configuration if they have been 
altered by calling "Set Normal Scroll Window" at $FB3C or 64316 
or -122(3. 

3. Position the cursor where desired before printing a string of 
characters: POKE the line number into CV and call VTAB for the 
line and then POKE the character number into CI1. 

4. Output the string of characters by the same means as if operating 
with scroll services, being careful not to unintentionally 
exceed window width or output carriage returns. Depending on 
your screen design, however, you may intentionally do each of 
these. 

Note that program output of a carriage return does not clear the line 
to the right of the carriage return, but keyboard input of a carriage 
return does (if reading the keyboard is being done by the Monitor get- 
line routines). 

If part of the screen is to be allocated as an operating Scroll Window 
while the remainder of the screen is to be directly addressed, then a 
different (lower) level of Monitor services must be. called upon. 

One way to support a divided screen is by using the Scroll Window for 
data input with the Monitor get-input-line services, and by using the 
Scroll Window support for whatever output the program intends to put 
there. Then use parts of LORES graphics support for placing characters 
on the screen outside of the Scroll Window, as described below. The 
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If 






fc 

fc 

t 
fc 
fc 
F 
fc 
fc 
E 
E 
fc 
fc 
fc 
fc 
fc 
fc 
fc 
fc 
fc 



aim here is to leave support of cursor position (zero page fields CV, 
CM, and I5ASL,H) up to the Monitor, and use other methods/fields for 
placing characters outside the Scroll Window. 

To place characters outside the Scroll Window, 

1. With the line number in the A-reg, call GBASCALC to set GBASL,H 
to point to the memory address of the left character position of 
the indicated screen line. 

2. With Y-reg indicating horizontal position on the line, store the 
desired character at (CBASL).Y. 

Note that this technique does not interfere with LORES plotting if the 

screen is being used in mixed mode, because PLOT calls always set 
OHASI,,ll as required without regard to possible previous contents. 

Another approach is available for the BASIC or APPLESOFT programmer. 
Again, the Scroll Window support can be used for some things, while 
the following approach can be used to place characters on the screen 
outside of tlie window. That approach is to compute the screen memory 
location for each byte to the screen, and poke, the byte there. A 
variation on that approach is shown by the sample program. In the 
sample, the Monitor VTAB routine is used to assist in building a table 
ill memory locations indicating the starting points of the screen 
Lines* This is an easier alternative than using the modulo arithmetic 
formula described in the section "Pages Four thru Eleven". Note that 
.Khling 1024 to each value in the. table gives the memory address for 
l /nit line in the secondary display area. 



ADDRESS TABLE 



inc t ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



AIM'S I OK OF SCROLL WINDOW 
Compute memory address for line in 
A-r.-).; set GBftSL.H. 

INS I DP. SCROLL WINDOW 

Wrlii- byte In A-reg to screen at 

cursor (CV),(CH) using INVFLG and 

nupport i ng cursor move. 
Wilic byte In A-reg to screen at 

(<;V),(CH) with cursor move but 

not INVFI.C. 
Clour Scroll Window to blanks, 

cursor to top left corner. 
Sel cv from A-reg, clear window to 

i'ikI nl window. 



F84 7 63559 -1977 GBASCALC A 



FDF0 65008 -528 C0UT1 



FDF6 65014 -522 COUTZ 



FC58 
FC5A 



64600 
64602 



-936 
-934 



HOME 



?A 

none 

A.Y 
A.Y 
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Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Place cursor at line (A) col (CH) 
setting CV and BASL,H from A-reg. 

Set BASL,H from CV (and WNDLFT). 

Set BASL,H from (A) and WNDLFT 
without regard to CV. 

Set BASL.H to left end of screen 
line (not window line) in A-reg. 



TB5B 533*7 -1189 tabV 



FC22 
FC24 



64546 -990 
64548 -988 



VTAB 
VTABZ 



A 

A 



FBC1 64449 -1087 BASCALC A 



CH 


36 


$24 


WNDLFT 


32 


$20 


CV 


37 


$25 


WNDWDTH 


33 


$21 


GBASL.H 


38-39 


$26-2 7 


WNDTOP 


34 


$22 


BASL, II 


40-41 


$28-29 


WNDBTM 


35 


$23 


INVFLG 


50 


$32 









APPLESOFT SAMPLE PROGRAM 

10 REM TEXT OUTPUT WITHOUT THE SCROLL WINDOW 

1 1 REM SAMPLE PROGRAM 

12 REM READS FROM KEYBOARD LINE, CHAR, STRINC 
14 REM AND PLACES THE STRING THERE 

1000 REM PROGRAM ENTRY 

10i0 DIM L%(23): REM LINE ADDR TABLE 

1100 GOSUB 63000; REM MAKE UP TABLE 

1199 REM PRINT PART OF TABLE JUST FOR SHOW 

1200 FOR I = TO 21: PRINT I,L%(I): NEXT 

1209 REM DELAY TO ALLOW LOOK AT IT. 

1210 FOR I ■ J. TO 5000: NEXT 

1220 PRINT: REM PRINT CR TO ALLOW CTL-S STOP IF DESIRED. 

1225 CALL - 936: REM CLEAR SCREEN BEFORE CHANGING WINDOW. 

1229 REM SET UP NEW WINDOW. 

1230 POKE 32,24: POKE 33,14: POKE 34,12: POKE 35,17 
1235 CAI.1. -936: REM PUT CURSOR INTO WINDOW AREA. 
1300 INPUT LI,CL,SS$:REM READ A COMMAND LINE. 

1399 REM ALLOW A WAY OUT 

1400 IF SS$ = "END" THEN 63900 
1500 SL = LEN (SS$) 

1509 REM CHECK LEGALITY OF LINE, ETC. 

1510 IF LI > 23 THEN 1810 

1511 IF CL > 39 THEN 1810 

1519 REM NOT PAST 40 THOUGH. 

1520 IF CL + SL > 39 THEN SL = 40 - CL 

1600 REM PUT CHARACTERS ONE AT A TIME. 

1601 FOR I - 1 TO SL 

1700 C$ = MID$ (SS$,I,1):C% = ASC (C$) 

1720 POKE L%(LI) + CL + I - 1,C% + 128 

1740 NEXT I 

1800 GOTO 1300: REM GO BACK FOR ANOTHER COMMAND. 



f 
t 
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i 
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1810 REM LINE OR CH TOO BIG - ERROR. 

1811 CALL - 936: PRINT "NOT SO BIG" 

1812 PRINT "LN ";LI: PRINT "CH ";CL 
1 82.0 GOTO 1800 

(.2999 REM 

i,!000 REM MAKE UP LINE ADDRESS TABLE 

i. 1010 X% = PEEK (37): REM REMEMBER CV 

M020 FOR I = TO 23 

63030 POKE 37,1: REM SET CV 

1.1031 CALL -990: REM CALL VTAB TO FILL BASL h BASH 

63035 1.%(I) = 256 * ( PEEK (41)) + PEEK (40) 

(.1040 NEXT I 

63045 REM TABLE SETUP DONE 

63046 REM RESTORE CV AND RETURN 

63050 POKE 37, XZ: CALL - 990: REM WITH PROPER BASL & BASH 

I. 101.0 RETURN 

l. )')00 CALL - 1233: END: REM RESTORE FULL WINDOW PRIMARY 



SE CONDARY DISPLAY ARE AS 

Tin- Apple II hardware allows use of either of two nemory areas for 
display to the screen. The first, or primary, is memory locations 
'.".W400-S07FF. The secondary text (and low resolution graphics) display 
urea is $0800-$0BFF. This area is normally overlaid by a user program 
or (lata, but in special circumstances a user may desire to make use of 
[Ills secondary area as a screen display area. 

Tilt" Monitor does not support the secondary display area as such. That 
In, the routines in the Monitor which determine screen area memory 
ii. 1.1 iuks from line number (CV) and character column (CH) do so only for 
i ho primary display area. These routines perform correctly only for 
I Ini'M 0-23. 

Following arc descriptions of two ways of using the secondary display 
uri'.i. 

COPY PRIMARY TO SECONDARY 

There are times when it is desirable to change the display very 
quickly, although the program produces the output slowly. For example, 
a program might display data found by scanning a disk file. The 
programmer might generate the original screen data in the primary 
display area, then move it to the secondary display area and set the 
hardware to display from secondary. The program may then proceed to 
generate the next screen data in the primary area while the operator 
Is looking at the Initial or previous display of results. A sample 
program is provided later in this section showing how the Monitor tlove 
routine can be used to move the contents of the primary display area 
in the secondary display area. 



46 MONITORS PEELED 



t 



KEYBOARD INPUT AND SCREEN OUTPUT 47 



SET BASL.H FOR SECONDARY DISPLAY PAGE 

When the Monitor places a character in the screen memory area, it does 
so using BASL.H as the address of the memory location for the left end 
of the line, and (CH) as the displacement from the left end of the 
line. BASL.H can be initialized to the memory location of a selected 
screen line by setting the desired line number in CV and then CALLing 
TABV. On return from that CALL, adding 4 to BASH changes BASI.,11 to 
point to memory for the desired line in the secondary display area. 
This will last until the program writes a carriage return or writes 
characters beyond the right end of the Scroll Window. 

If the Monitor is called upon to read from the keyboard, it "echoes" 
the input characters to the screen. Input of a carriage return, one 
backspace too many, a cursor movement, or a screen clearing Escape 
Key function will cause BASL.H to be restored by the Monitor to point 
within the primary display area. 

In the case where one display area is to be used for text and the 
other for graphics, it is preferable to keep the graphics in the 
primary area and the text in the secondary area because the Monitor 
recomputes CBASL.H continually for plotting functions, whereas for 
text output BASL.H is recomputed only when it is necessary to move the 
cursor to a new line. 

It must be noted that APPLESOFT also does not (easily) support the 
secondary display area. APPLESOFT in RAM occupies that part of memory, 
and then some. Firmware APPLESOFT places the program code in that 
memory space, unless special actions are taken. Those actions may be 
noted in the sample program, which uses APPLESOFT and the secondary 
display area. POKE 104,12 and 3027,0 before loading the program. 

ADDRESS TABLE 



Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Place cursor at line (A), col (CH) 
(store A to CV and compute BASL.H 
by JMP to VTAB. 

Set BASL.H from CV and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL.H from A-reg and WNDLFT 
by call BASCALC and add WNDLFT. 

Set BASL.H to memory address for 
left character of screen (not 
window) of line in A-reg. 



FB5B 64347 -1189 TABV 



FC22 64546 -990 VTAB 



FC24 64548 -988 VTABZ 



FBC1 64449 -1087 BASCALC 






y 
E 

► 
¥ 

E 
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3D 
3D 



• 
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F" 



Fund ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



FDF0 



Write byte in A-reg to screen at 
cursor (CV).(CH) using INVFLG and 
supporting cursor move. 

Write byte in A-reg to screen at 
(CV).(CH) with cursor move but 
not INVFLG. 

Monitor Command Processor MOVE 
routine. (A1L.H) thru (A2L.H) is 
moved to (A4L,H) thru whatever. 

Monitor Command Processor GO entry. FEB6 
Set PCL,H from A1L.H if entered. & 
Call RESTORE, set all regs but S & FEB9 
.IMP via PCL.H. FEBC 



-528 C0UT1 ?A 



FDF6 65014 -522 COUTZ none 



FE2C 65068 -468 MOVE A (Y=0) 



65206 -330 GO A,X,Y,P 



65209 
65212 



-327 
-324 



DIRECT CONTROL ADDRESSES 

The following table describes the methods of setting the hardware for 
display to various screen configurations by direct control rather than 
by calling the Monitor. For some of these items there is no routine 
in the Monitor which could be called to perform the function. 



I'u net ion 



Method 



.Set CRAPHICS display mode. 

Set TEXT display mode. 

Sot Graphics mode to Full Screen. 

Sot MIXED GRAPHICS and TEXT mode. 

Sot display to Primary Page. 

Sot display to Secondary Page. 

Clear HIRES = Set LORES mode. 

Sot HIRES Graphics mode. 

Sot top line of Scroll Window. 

Sot left edge of Scroll Window. 

Sot width of Scroll Window. 

Sot bottom line of Scroll Window. 



POKE 


-16304,0 


or 


STA 


C050 


POKE 


-16303,0 


or 


STA 


C051 


POKE 


-16302,0 


or 


STA 


C052 


POKE 


-16301,0 


or 


STA 


C053 


POKE 


-16300,0 


or 


STA 


C054 


POKE 


-16299,0 


or 


STA 


C055 


POKE 


-16298,0 


or 


STA 


C056 


POKE 


-16297,0 


or 


STA 


C057 



POKE 34, line-number (0-23) 
Bottom must be greater than top. 
POKE 32, column-number (0-39) 
Left edge + width not to exceed 40. 
POKE 33, number-of -columns (1-40), 
Left edge + width not to exceed 40. 
POKE 35, line-number (1-24) 
Bottom must be greater than top. 



CH 36 $24 

CV 37 $25 

CBASL.H 38-39 $26-27 

BASI.,11 40-4 1 $28-29 

INVFLG 50 $32 



WNDLFT 32 $20 

WNDWDTH 33 $2 1 

WNDTOP 34 $22 

WNDBTM 35 $23 
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INTEGER BASIC SAMPLE PROGRAM 

10 REM SAMPLE SECONDARY DISPLAY WAY 

11 REM USING MONITOR MOVE TECHNIQUE 



19 GOTO 



REM BYPASS SUBROUTINES 



20 REM MOVE AREA 1 TO AREA 2 

21 POKE 60,0: POKE 61, A: REM SET A1L.H 

22 POKE 62,255: POKE 63,7: REM SET A2L.H 

23 POKE 66,0: POKE 67,8: REM SET A4L.H 

25 POKE 71,0: REM SET Y-REG=0 

26 POKE 58,44: REM $2C 

27 POKE 59,254: REM $FE 

28 CALL -327: REM DO THE MOVE 

29 RETURN 

1000 REM PROCRAM START 

1001 IF PEEK (75)<12 THEN 32000 



1100 CALL -936: 



REM CLEAR THE SCREEN 



1200 PRINT "THIS IS THE SECONDARY DISPLAY AREA" 
1210 PRINT "NOTE THE LACK OF CURSOR" 



1300 GOSUB 20: 



REM MOVE TO SECONDARY 



1400 
1410 

1500 
1600 

1700 



CALL -936: REM CLEAR PRIMARY AGAIN 

PRINT "THIS IS THE PRIMARY AREA AGAIN" 

POKE -16299,0: REM SET SECONDARY 

FOR 1=1 TO 4000: NEXT I 

POKE -16300,0: REM RACK TO PRIMARY 

END 



32000 



REM NO LOMEM ERROR 

PRINT "PLEASE LOAD ACAIN" 
PRINT "AFTER LOMEM: 30 72 " 
32003 KND 



32001 
32002 



APPLESOFT SAMPLE PROGRAM 

10 REM SECONDARY DISPLAY AREA WAYS AND MEANS 

11 REM SAMPLE PROCRAM 

12 REM READS FROM KEYBOARD 

13 REM COMMAND, LINE, CHARACTER, STRING 

14 REM AND PLACES THE STRING 

1000 REM PROGRAM ENTRY 

1009 REM IS SECONDARY AREA CLEAR? 

1010 IF PEEK (104) < 12 THEN 62000 



1020 GOSUB 63000: 
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REM CLEAR THE SECONDARY 



h 
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I 100 
1109 
1310 

nil 

1)12 

1390 

1 400 
1410 
14 20 
1430 
1431 
1440 
I 4 50 
I '.00 
1510 
1511 
! r > 1 2 
1 590 
1600 
1610 
I 620 
1/00 
1/10 
1800 
1 Ml 

I 111 I 
IH12 
I 820 

.'000 
2010 

.'100 
'.'110 

2200 



REM MAIN 
IF Q = THEN 1390: 

POKE 37,21: 

CALL - 990: 

POKE 41, PEEK (41) + 4: 



PROGRAM 
REM INPUT TO PRIMARY 
REM SET INPUT TO SECONDARY 
REM SET LINE 21 
REM SET BASL.H 
REM SET BASH TO SECONDARY 



INPUT CC$,LI,CL,SS$ 

IF CCS = "END" THEN 63900 



REM SET SHOW TO SECONDARY AREA 
REM SET SHOW TO PRIMARY AREA 
REM SET INPUT SECONDARY 
REM SET INPUT PRIMARY 
REM PUT STRING TO SECONDARY 
GOTO 1300 



IF CC$ = "S" THEN 2000: 

IF CC$ = "P" THEN 2100: 

IF CC$ = "Q" THEN 2200: 

IF CC$ - "R" THEN 2300: 

IF CC$ = "X" THEN 1500: 

POKE 16300,0: PRINT "WHAT? 

SI, = LEN (SS$) 

IF LI > 23 THEN 1810 

IF CL > 39 THEN 1810 

IF a, + SL > 39 THEN SL - 40 - CL: REM NO AUTO CR 

CX = PEEK (37): REM REMEMBER CV 

POKE 37, LI: GALL - 990: POKE 41, PEEK (4!) + 4 

POKE 37.CX: REM RESTORE CV 

POKE 36, CL: REM SET CH FOR THIS PRINT 

SP$ = LEFTS (SS«,SL): REM SHORTEN PRINT IN THIS SMPL 

PRINT SP$ 

GOTO 1300 

CALL - 936: 

PRINT "NOT SO BIG": 

PRINT "LN ";LI: PRINT "CH ";CL 

GOTO 1300 



REM VALUE TOO LARGE. 

REM PRINT IN PRIMARY ONLY 



POKE - 16299,0: 
GOTO 1300 

POKE - 16300,0: 
GOTO 1300 

Q - 1: GOTO 1300: 
= 0: GOTO 1300: 



REM SET SECONDARY 



REM SET PRIMARY 



REM SET INPUT TO SECONDARY 
REM SET INPUT TO PRIMARY 
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F *1 



62000 PRINT "SETUP NOT MADE, NOW BEING DONE" 

62010 PRINT "RUN THE PROGRAM AGAIN" 

62018 REM 104 IS APPLESOFT ROM START 

62019 REM BYTE BEFORE $C01 MUST BE ZERO 

62020 POKE 3072,0: POKE 104,12: END 

63000 BL$ = " "; REM CLEAR SECONDARY AREA 

63001 FOR I = 1 TO 3:BL$ = BL$ + BL$: NEXT 
63005 CX = PEEK (37) 

63010 FOR I = TO 23 

63020 POKE 37,1: CALL - 990 

63030 POKE 41, PEEK (41) + 4 

63040 POKE 36,0 

63050 PRINT BLS 

63060 NEXT 

63070 POKE 37, CX: POKE 36,0 

63080 RETURN 

63900 POKE 16300,0: CALL - 1233: END 
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CHAPTER 3 

INTERRUPT PROCESSING 

Some computers are capable of reacting to the raising (or dropping) of 
;i signal line by instantly saving the current status of the processor, 
.lii.'i quickly transferring control to some other program within £he 
computer. Changing the state of that line is called "causing an 
Interrupt". The functions of the processor in saving its current state 
and transferring control to some other location in memory is called 
"taking an interrupt". The program which then receives control is 
expected to "handle the interrupt". 

The 6502 microprocessor in the Apple II is sensitive to three 
Interrupt categories. These are RESET, NMI (Non-Maskable Interrupt), 
and IRQ. Execution of a BRK instruction causes a form of IRQ interrupt 
io be simulated. 

The purpose of an interrupt, in general, is to allow some kind of 
external device to make a condition known to a running program without 
the program having to periodically or continually test for the 

hardware condition. An example of the latter type of operation is the 
Apple TI keyboard operation. When keyboard input is to be accepted 

iniTinty location $C000 is tested repeatedly until presence of the sign 
Ml indicates that a key lias been pressed. An example of interrupt 
driven processing could be a special peripheral controller card, 
ail ached to a telephone line, which caused the computer to be taken 
over by a data acquisition program any time data was available, but 
would allow the machine to be used for other things in between 
t ranaml salons . 

When a computer recognizes (takes) an interrupt, the hardware should 
ni-romplish three things. 

1. Save processor status in such a way that execution of the 
interrupted program can be continued after the interrupt has 
been "serviced" or handled. 

2. Prevent further recognition of that class of interrupts until 
the Interrupt handling program restores that interruptability. 

t. Transfer control to the program meant to handle this type or 
category of Interrupt. 

Willi the 6502 in the Apple II variations on the above three steps are 
i .iki'ii for the three different interrupt classes or categories. 

I . When an IRQ (or BRK) or NMI interrupt is taken, the contents of 
the program counter and the P-reg (processor status register) 
are respectively pushed onto the stack. When a RESET interrupt 
Is taken, the processor holds the memory in READ mode until 
control is transferred to the handler, so nothing of processor 
statue is pushed onto the stack. 

INTERRUPT PROCESSING 53 



I 



2. 



3. 



When the 6502 takes an IRQ interrupt, the P-reg is modified. II 
a BRK instruction is executed, the $10 bit oi the processor 
status register is set to one before the P-reg is pushed onto 
the stack. If the IRQ line was the cause of the interrupt, this 
bit is set to zero before the P-reg is pushed onto the stack. 

After the P-reg is pushed onto the stack, the $04 bit is set to 
inhibit recognition of any more IRQ category interrupts until 
the interrupt handling program clears this condition. 

With RESET and NMI there is no available facility for 
preventing another interrupt while the current interrupt is 
being handled. 

The 6502 transfers control to the appropriate program for 
handling an interrupt by means of "vectors". Memory addresses 
$FFFA-$FFFF are reserved for this purpose. The final step of 
taking an interrupt is loading of the program counter from the 
vector for this class or category of interrupt. The following 
table indicates the locations of the interrupt handlers for the 
two Monitors. 



Interrupt Vector 
Taken Address 



Monitor Old Monitor Autostart 
Label Address Address 



NMI 


$FFFA-B 


"NMI" 


$03FB 


$03FB 


RESET 


$FFFC-D 


RESET 


$FF59 


$FA62 


IRQ/BRK 


$FFFE-F 


IRQ 


$FA86 


$FA40 



NMI INTERRUPT 

The Apple II Monitor does not interfere with user handling of 
the NMI interrupt. That is, the vector for NMI causes the 6502 
to transfer control of the computer to location $03FB, where 
the user is to place a JMP to the user-provided handler for 
this type of interrupt. 

RESET INTERRUPT SUPPORT 

Pressing the RESET key on the keyboard causes a RESET interrupt 
to occur. On all Apple II's but the very early ones, power-on 
also results in generation of a RESET interrupt. 

The actions performed by the Autostart Monitor and the Old 
Monitor RESET interrupt handlers are considerably different. 
Therefore, they will be described separately. 
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IRQ/BRK INTERRUPT HANDLING 

When either an IRQ interrupt is taken or a BRK instruction is 
executed, the 6502 performs an interrupt sequence. The contents 
of the program counter are pushed onto the stack. The 010 bit 
of the P-reg is set or cleared to indicate the IRQ line vs. 
BRK instruction, and then it is pushed onto the stack. The 6502 
then sets the $04 bit of the P-reg, preventing another 
interrupt of this type from being recognized vintil this one is 
handled. The 6502 then loads the Program Counter from the IRQ 
hardware prescribed vector at $FFFE-$FFFF, and allows operation 
of the computer to continue from that point. The Interrupt 
Handler for IRQ interrupts is now in control. 



R E SET INTERRUPT— OLD MONITOR 

When a RESET interrupt is taken the Old Monitor establishes a 
predefined configuration of hardware and page zero fields. Primarily, 
the keyboard Is set as the current input device, the screen is set as 
l ho current output device, and the screen configuration is set to full 
Hcreen Scroll Window with normal video. 

Page zero fields KSWL,H, CSWL,H are set to make the keyboard and 
screen active. WNDLFT, WNDWDTH, WNDTOP, WNDBTM are set to define the 
whole screen as the Scroll Window. CV and CH are set to place the 
cursor at the bottom left corner of the screen. INVFI.G is set to 
normal (white on black). 

Hardware addresses are referenced to establish a known conf igviration 
an fo 1 1 ows . 

$C056 - clear high resolution graphics 
$C#54 - display primary area 
$C051 - set text mode 

Control Is then transferred to the "top" of the Monitor at label MON, 
location $FF65, at which point the "bell" is sounded and the Monitor 
rulers the command line read routine. 
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ADDRESS TABLE 



Function 



Hex +Dec -Dec Monitor Resist ers 
Addr Addr Addr Label Destroyed 



Set STATUS in SAVE ateato^ 

Clear HIRES. 

Set primary display area. 

Set TEXT mode. 

Set full screen scroll window by 

branch to SETWND with (A)=0. 
Set WNDTOP from A-reg. 
Load A with for WNDLFT. 
Set WNDLFT from A-reg. 
Load A with 40 for WNDWDTH. 
Set WNDWDTH from A-reg. 
Load A with 24 for WNDBTM. 
Set WNDBTM from A-reg. 
Load A with 23 for CV. 

Set CV from A-reg. 

JMP to VTAB to set BASL.H «, RTS. 

Set INVFLG to SFF = normal video. 

Set INVFLG from Y-reg. 

Set port (keyboard) for input. 

Set port (screen) for output. 



& FB2F 
& FB33 
& FB36 
& FB39 
PB3C 



FB4B 
FB4D 
FB4F 
FB51 
FB53 



6 FB55 



& FB57 
& FB59 

& FB5B 

FB5D 
FF84 
FF.S6 
FE89 
FF.93 



643(23 
64307 
64310 
64313 
64316 

64331 
64333 
64335 
64337 
64339 
64341 
64343 
64345 
64347 
64349 
65156 
65158 
65161 
65171 



-1233 INIT A~ 

-1229 A 

-1226 A 

-1 223 SF.TTXT A 

-1220 A 



SF.TWNf) 



-1205 
-1203 

-1201 
-1 199 
-1197 

-1 195 
-1193 

-1191 

■1189 TABV 

-1187 

-380 

-378 

-375 

-365 



SETNORM 
SF.TIFLC 
SETKBD 
SETVID 



A 
A 
A 
A 
A 
A 
A 
A 

A 
A 
Y 

none 

A.X.Y 

A,X,Y 



FK59 65369 -167 RESET 



Monitor entry on RESET key pressed 
or Power on. 

Call SETNORM - white on black. & 

Call INIT -Text A full scroll. & FF5C 65372 -164 

Call SETVID - screen as output. & FF5F 65375 -161 

Call SETKBD - keyboard = input. & FF62 65378 -158 

Clear 6502 decimal mode (set hex) & FF65 65381 -1 55 

Sound bell. & FF66 65382 -154 

Monitor Command Processor Entry. FF69 65385 -151 

Set "*" as prompt character. 



HON 



MO!!X 



RESET INTERRUPT— AUTOSTART MONITOR 

The Autostart Monitor performs functions of three categories in 
handling a RESET interrupt. 

1. Establish a known hardware/software environment with regards to 
the basic machine. 

2. If the contents of memory (page three) do not Indicate that a 
power-on initialization has been performed, the Autostart 
Monitor will perform power-on initialization. If a disk 
controller card is present in one of the slots, power-on 
initialization includes bootstrapping from that slot. If no 
disk controller card is in the machine a control-B entry is 
simulated. Tn either case, the appropriate language processor 
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receives control at the end of power-on initialization, with 
page three fields set to indicate that a warm start is to be 
performed on ensuing interrupts from the RESET key. 

3. If the contents of memory (page three) indicate that power-on 
Initialization has already been performed, the Autostart 
Monitor will transfer control via the RESET (Soft Entry) vector 

in psge three at the conclusion of "handling" the RESET 
interrupt. If DOS has been booted, this will result in transfer 

of control back to the current language processor through DOS. 
If DOS is not present, the normal setting of the RESET vector 
will cause simulation of a control— C (warm start) reentry into 
the current language. 

INITIALIZE SYSTEM CONFIGURATION 

Win ■ n a RESET interrupt is taken, the Autostart Monitor establishes a 
predefined configuration of hardware and page zero fields. Primarily, 
llic keyboard is set as the current input device, the screen is set as 
l lie current output device, and the screen configuration is set to full 
Bcreen Scroll Window with normal video. 

Page zero fields KSWL,H, CSWL,1I are set to make the keyboard and 
Ht-reen active. WNDLFT, WNDWDTH, WNDTOP, WNDBTM are set to define the 
win. !-• .screen as the Scroll Window. CV and CH are set to place the 
cursor at the bottom left corner of the screen. INVFLG is set to 
.'m him I (white on black). 

Hardware addresses are referenced to establish a known configuration 
mm I il 1 low. 

',;c0'ili - clear high resolution graphics 

■;t:0 "iA - display primary area 

m:0'iI - set text mode 

';.<:0'>K - clear AN0 = TTL IX) 

?<:0 r )A - clear AMI = TTL LO 

•;.<:0M) - net AN 2 = TTL HI 

SC05F - set AM3 = TTL III 

•i< :i-"K I' - turn off Expansion ROM 

■)rsl|0 - clear keyboard strobe 

On rompW'l Ion of all the above, the Autostart Monitor sounds the BELL. 



COLD/WARM DETERMINATION 



A 



ph t libit ah i rig a known basic hardware and software (screen 
iimiinli;) environment, the Autostart Monitor executes a test to 
del i-i mi in- whether power— on initialization is to be performed. Page 
Mm.' Incnttuns S03F2-$03F3 contain the RESET (Soft Entry) vector, the 
.iildii','.!-, io which the Autostart Monitor will transfer control on 
i.iiii]. 1 .1 I on ill handling the RF^SF'T interrupt. Location S03F4 is a 
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validation byte, used with R0.3F3 to indicate whether or not power-on 
initialization is to be performed. If the Exclusive OR of the contents 
of these two memory locations is $A5, then power-on initialization is 
considered to have been previously accomplished, and $03F2-$03F3 is 
considered a valid address to which to transfer control. 

POWER-ON INITIALIZATION 

The first functions of power-on initialization are to establish in 
page three ($03F0-$03F4) the BRK interrupt vector (see "BRK 
Instruction. Handling - Autostart Monitor") and the RESET Soft Entry 
interrupt vector with validation byte. The RESET vector at this point 

is set to $E000 to simulate a control-B (initialize) entry for the 
current language processor. 

The Autostart Monitor next performs a routine which teats each clot, 
from slot 7 through sloe 1, for presence of a disk controller card. 
If one is found, a jump is performed to $CX00 where X is the slot 
number in which the disk controller has been found. This will result 
in loading of DOS and presumably execution of the HELLO program. 
Note: DOS 3.2 Replaces the RESET vector at $03F2-$03F3 and validation 
byte at $03F4, so that on a RESET interrupt, control will be passed 
thro\igh DOS back to the current language processor. 

If no disk controller card is found the Autostart Monitor changes the 
RESET vector to SE003 (language restart or control-C entry point) and 
then jumps to $E000 (language initialize entry point). 

SYSTEM RESTART 

If the $03F3-$03F4 test described above is passed, the RESET vector ar 
$03F2-$03F3 is considered mostly valid. If it contains $E000, it is 
changed to SF.003 and then BASIC is entered at $E000. If It is not 
$E000, it executes an Indirect Jtinp via $03F2-$03F3 to the address 
specified therein. 

RESET VECTOR MODIFICATION BY USER 

The RESET vector may be modified by user or program to send control to 

some other address in the machine at the completion of Monitor 

handling of the Interrupt. For example, to cause the RESET key to 

result in placing the machine in Monitor mode, execute the following 
program; 

10 POKE 1010, 105 

20 POKE 1011,255 

30 POKE 1012,90 

40 CALL -151: REM ENTER MONITOR 

50 END 
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The following program is more general purpose. In order to set the 
RESET vector to some address, poke the address into locations 1010- 
11*11 (S03F2-$03F3) and then CALL Autostart Monitor label SETPWRC 
($FB6F or 64367 or -1169) to set location 1012 ($03F4). 

1 REM AD IS ADDRESS OF 
I I REM ROUTINE TO RECEIVE 

I 2 REM CONTROL AFTER RESET 

/0 POKE (010, Ml: REM SET LO BYTE 

ilfi POKE 1011, AD/256: REM SET HI 
40 CALL -1169: REM SET 1012 

Note: If you try to run this on a system with an Old Monitor ROM, you 
m,iv destroy the program, or even the entire diskette. To avoid this 
problem, execute the steps in the above program manually, on a system 
with an Autostart ROM. Then, PEEK location 1012 and get the value to 
I'oKE Into 1012, alleviating the need to CALL-1169 at all. 



ADDRESS TABLE 



Fund Ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



or 

i:i. 



C.i 



C.I 

C.I 

lull 

Clr 

( 



Cli 

ci 

f.W'M 

Cnl I 
TV«( 

1 1 
I l 

T.'Nl 

Null 

r.t 

Trul 
CO] 

HOK 

SOFT 

Ini 



Hon I u>r entry on RESET key pressed 
Power on. 

- clear 6502 dec, (set hex). 
II SKTNORM - white on black. 
II I NIT - Text, full scroll. 

1 I SI'.TVID - screen as output. 
I I SETKBD - keyboard as input 
'ullsse hardware to known state, 
ar AN0 to TTL LO (ref. C058). & 
ar ANl to TTL LO (ref. C05A). 

AN 2 to TTL III (ref. C05D). 

AMI to TTL HI (ref. C05F). 
nr Expansion ROM (ref. CFFF). 
nr keyboard strobe. 
r 65(f2 -decimal mode (set hex).& 

BKLL. & 

$3F3 vs. S3F4: Cold or Warm 
Cold goto PWRUP. 
CV\|.'i) XOR (S3F4) = $A5, Warm. 

SOFTEV (S3F2) low byte: 
-'I'm means Oold Start done - 
lo MOMX to use SOFTEV vector. 
n mr.i.'iM restart warm maybe. 

SOFTBV III for $E0 - language 
.J atari entry. Tf not equal, 
T.V In ok to use, goto NOFIX. 
'.V - $E000, change to $E003 for 
■ re nr'..- and goto $F,000 to cold 



FA62 64098 -1438 RESET 



FA63 
FA66 
FA69 
FA6C 
FA6F 

FA72 
FA75 
FA 78 
FA7B 
FA7F, 
FA81 
FA82 
FA85 



64099 
64102 
64105 
64108 
64111 

64114 
64117 
64120 
64123 
64126 
64129 
64130 
641.33 



-1437 
-1434 
-1431 
-1428 
-1425 

-1422 
-1419 
-1416 
-1413 
-1410 
-1407 
-1406 
-1403 



TNITAN 



NEWMON 



FA8F 64143 -1393 



FA94 64148 -1388 



FA9B 64155 -1381 FIXSEV 



il an i hr language . 
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Function 



Hex +T)ec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



JHP (SOFTEV): Use the Soft Entry 
vector to exit RESET handler. 

Cold Start on RESET entry point. 
Call APPLEII to clear screen and 
put title on top line. & 

Set page 3 interrupt vectors for 
BRK (OLDBRK) and SOFTEV ($E000). 

Look for disk controller card in 
slots 7 thru 1. If none, goto 
FIXSEV above to set SOFTEV for 
BASIC restart & enter BASIC cold. 
If disk found, JHP (LOC0) to boot 
from the disk. 

Clear screen (call HOME). & 

Place APPLE II legend on top .line. 

Set PWREDUP ($3F4) = (S3F3) XOR $A5 



FAA3 
FAA6 

KAA9 
FAB4 



Set STATUS in SAVE area Co 0. 

Clear HIRES. 

Set pritsary display area. 

Set TEXT mode. 

Set full screen scroll window by 

branch to SETWND with (A)=0. 
Set WNDTOP F rom A-reg. 
Load A with for WN1M.FT. 
Set WMDLFT from A-reg. 

Load A with 40 for WNDWDTH. 

Set UNDWDTH from A-reg. 

Load A with 24 for WNDBTM. 

Set WNDBTM from A-reg. 

Load A with 23 for CV. 

Set CV from A-reg. 

Jump to VTAB to set BASL.H & RTS. 

Set INVFLG to $FF = normal video. 

Set INVFLG from Y-reg. 

Set port (keyboard) for input. 

Set port (screen) for output. 



FB60 
FB63 
FB6F 
FB2F 
FB33 
FS36 
FB39 
FB3C 

FB4B 
FB4D 
FB4F 

FB51 
FB53 

FB55 
FB57 
FB59 
FB5B 

FB5D 
FK84 

FK86 
FE89 
FF.93 



64163 
64166 

64169 

64180 



64352 
64355 
64367 
64303 
64307 
64310 
64313 
64316 

64331 
64333 
64335 

64337 
64339 
64341 
64343 
64345 
64347 

64349 
65156 
65158 
65161 
65171 



-1373 NOFIX 

-1370 PWRUP 

-1367 SETPG3 
-1356 



-1184 
-1181 
-1169 
-1233 
-1229 
-1226 
-1223 
-1220 

-1205 
-1203 
-1201 

-1199 
-1197 

-1195 

-1193 

-1191 

-1189 

-1187 

-380 

-378 

-375 

-365 



APPLEII 

SETPWRC 

IN IT 



SF.TTXT 



SKTVND 



TABV 

SETNORM 
SETIFLG 
SETKBD 
SETVII) 



A,Y 

A,Y 

A 

A 

A 

A 

A 

A 

A 
A 
A 

A 
A 

A 

A 

A 

A 

A 

Y 

none 

A,X,Y 

A,X,Y 



FOR COMPATIBILITY WITH 01.11 MONITOR FF59 65369 -167 OLDRST 
the RESET routine is still here. 
Call SETNORM - white on black. & 

Call INIT -Text & full scroll. & FF5C 65372 -164 

Call SETV1D - screen as output. & FF5F 65375 -161 

Call SETKBD - keyboard = input. & FF62 6537 8 -158 

Clear 6502 decimal mode, set hex. & FF65 65381 -155 MOH 

Sound beli. & FF66 65382 -154 

Monitor Command Processor Entry. FF69 65385 -151 MOHZ 
Set "*" as prompt character. 
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r 

Z 

Z 
Z 

Z 

z 
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z 
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Z 
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T 



y 
^ 

^ 

I 
> 
I 

fc 
I 
> 
I 
I 
I 



IRQ/BRK INTERRUPTS 



IRQ/BRK INTERRUPT RECOGNITION 



When either an IRQ interrupt is taken or a BRK instruction is executed 
1 lie 6502 performs an interrupt sequence. The contents of the program 
counter are pushed onto the stack. The §10 bit of the P-reg is set or 
cleared in indication of IRQ line vs. BRK instruction, and then it is 
pushed onto the stack. The 6502 then sets the $04 hit of P-reg, 
preventing another interrupt of this type from being recognized until 
this one Is handled. The 6502 then loads the Program Counter from the 
1 1«) hardware prescribed vector at $FFFE-$FFFF, and allows operation of 
i he computer to continue from that point. The Interrupt Handler for 
IRQ interrupts is now in control, 

IRQ INTERRUPT HANDLING 

The 6502 directing vector at $FFFE-$FFFF points to Monitor program 
label IRQ in both the Old Monitor and the Autostart Monitor. It will 
he noted In the address table that the address is different, however. 

The handling of an IRQ interrupt is identical in both Monitors. The 
conf onts of the A-reg are stored at ACC ($45) for future reference. 
The processor status (P-reg) pushed onto the stack by the taking of 
the Interrupt is popped into the A-reg, and then pushed back onto the 
"t, ick so that the stack and pointer are not changed. By shifting the 
A-reg left three bits, the IRQ routine moves into the sign bit the bit 
which Indicates (in this case by being a zero) that the interrupt is 
/in IRQ interrupt rather than execution of a BRK instruction. The 
lliinllor then executes a Jump Indirect instruction via location $03FE- 
S03FF to the user provided IRQ Interrupt Handler. Note that on an IRQ 
Interrupt the X, Y, and S registers are not saved by the Monitor. 
Ainu, the interrupt handler has the responsibility of clearing the $04 
I'll mi exit to allow further interrupts. 

BRK INSTRUCTION INTERRUPT 

Kxrcut I on of a BRK instruction causes the 6502 to simulate an IRQ 
Interrupt with minor changes. Due to the method the instruction is 
li.md I i-il , the address pushed onto the stack as part of the interrupt 
m I inn I .'it Ion is two bytes beyond the BRK instruction executed. 

Helm., pushing the P-reg onto the stack, the $10 bit is set to 
Indicate to the interrupt handling routine that the cause of the 
Interrupt wns execution of a BRK instruction rather than the IRQ line. 
Al i ci pinching the P-reg onto the stack, the $04 bit is set to inhibit 
IRQ Interrupts from being recognized until the interrupt handler 
clcniii the condition. Control is then transferred according to the 
6502 IRQ Interrupt vector to Monitor label IRQ. As described above 
regiirdlng handling of an IRQ interrupt, the IRQ routine first stores 
the A-reg "' ACC ($45) for future reference, and then uses the A-reg 
In cesl i lie stacked P-reg contents for a one in the $10 position. The 
hi nek and hi .ick pointer are not changed by this operation. The result 
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of the test is a transfer of control to Monitor label BREAK. Note In 
the address table that the address of BREAK Is not the same In the two 
Monitors . 

BRK INSTRUCTION-SAVING OF STATUS 

In each Monitor the first thing done in the BREAK routine is to save 
full machine status in page zero. The contents of the A-reg have 
already been stored by entry into the IRQ interrupt handler. The BREAK 
routine pops the stacked contents of the P-reg from the stack, and 
does a JSR to SAV1 at which point the remaining registers are saved. 
Note that this clears the $04 bit, allowing further IRQ or BRK 
interrupts to be taken. The S-reg saved at that time, however, has 
been incremented once by popping the P-reg back from the stack and 
decremented twice by the JSR to SAV1. On return from SAV1, the BREAK 
routine pops the Program Counter from the stack and stores it in page 
zero locations PCL-PCH. The address table at the end of this section 
indicates the page zero locations at which the above items are stored. 



BRK INSTRUCTION -OLD MONITOR 

The function of the BRK instruction interrupt handler of the Old 
Monitor is to display through COUT the machine status at the time the 
BRK instruction was encountered, and then return control to the top of 
the Monitor at label MON. The details above describe the handling of 
the interrupt through storage of machine status in page zero, 
including PCL, I?. The Old Monitor BREAK routine next does a JSR to 
INSDS1 to display the instruction at the address indicated by PCL-PCH 
(which is two bytes beyond the BRK executed), and a JSR to RGDSP1 to 
display the contents of the five registers, P, A, X, V, S. Note that 
the S-reg as displayed is two less than it was at the time of the BRK 
execution due to the JSR to SAV). On completion of the register 
display, a JMP to MON completes the handling of the Interrupt. 

BRK INSTRUCTION -AUTOSTART MONITOR 

The Autostart Monitor handles IRQ interrupt which is really a BRK 
instruction interrupt by saving registers and Program Counter In page 
zero locations. The Autostart ttonitor BREAK routine then exits via the 
Apple-II BREAK vector at $03F0-$03F1. Thus, it is possible for a user 
program to gain control at that point and do something other than to 
display the registers and return to the Monitor command processor. 
Such a program must be sure to clear the $04 bit in the P-reg on 
return. During RESET interrupt handling for power-on, this vector la 
initialized to point at Autostart Monitor label OLDBRK, which routine 
does the same thing as was done in Old Monitor. That is, it does a JSR 
to INSDS1 to display the disassembled instruction at the location 
indicated by PCL- PCH, a JSR to RGDSP1 to display the register 
contents, and a JMP to MON to complete the handling of the Interrupt. 
Note: after DOS 3.2 has destroyed page 3 during the bootstrap 
operation, it restores this vector to point to $FA59 V OLDBRK. 



62 MONITORS PEELED 



F 


-I 
















* 


31 


ADDRESS TABLE 














Function 




Hex 


+Dec 


-Dec 


Monitor 


Registers 


h 








Addr 


Addr 


Addr 


Label 


Destroyed 


1- 


Disassemble the instruction at 




F8D0 


63696 


-1840 


INSTDSF 


A.X.Y 


(PCL, II), print thru COUT. 












"» "» 






Display registers thru COUT from 




FAD7 


64215 


-1321 


REGDSP 


A,X 


V 


he 


save area, after carriage return 


















Display registers thru COUT from 




FADA 


64218 


-1318 


RGDSP1 


A,X 






save area. 














► 


WL 


Save 6502 regs at $45-49. 
Save A-reg at ACC $45. 


& 


FF4a 


65354 


-182 


SATO 


A,X 


* 


m 


Save X-reg at XREG $46. 


& 


FF4C 


65356 


-180 


SAV1. 








Save Y-reg at YREG $47. 


& 


FF4E 


65358 


-178 






t- 


m 


Save P-reg at STATUS $48. 


& 


FF50 


65360 


-176 






Save S-reg at SPNT $49. 


& 


FF54 


65364 


-172 










Clear 6502 decimal mode (set hex). 












fc 


<m 


Clear 6502 decimal mode (set hex) 


(, 


FF65 


65381 


-155 


MON 






Sound bell. 


& 


FF66 


65382 


-154 






C 


m 


Monitor Command Processor Entry. 




FF69 


65385 


-151 


KONZ 




Set "*" as prompt character. 














h 


3 


AUTOSTART TRQ/BRK HANDLING 














► 


m 


Determine whether interrupt was 




FA40 


64064 


-1472 


IRQ 


A 


IRQ or BRK, transfer control 


















accordingly. 














V 


a 


Handle BRK interrupt: 




FA4C 


64076 


-1460 


BREAK 


A.X.Y 


Restore P-reg from stack. 


















Save registers (SAV1) X,Y,P,S. 














¥• 


::« 


Move interrupt location from stack 
















to PCL.H. 














•» 


!« 


JMP (BRKV) to possibly user 














specified routine (normally to 


















OLDBRK, below). 














^ 


m 


Default BRK interrupt, handler 
completion routine 




FA59 


64089 


-1447 


OLDBRK 


A.X.Y 


► 


m 


Display instruction (2 bytes past 


) 


► 










Display registers, JMP to MON. 














p 


■ 


OLD MONITOR IRQ/BRK HANDLINC 














h 


m 


Determine whether interrupt was 




FA86 


64134 


-1402 


IRQ 


A 


IRQ or BRK, transfer control 


















accordingly. 














h 


'j 


Handle BRK Interrupt: 
Save registers, 




FA92 


64146 


-1390 


BREAK 


A.X.Y 


fc 


m 

m 


Display instruction (2 bytes past) 


> 










Display registers, JMP to MON. 














1- 


PCL.H 58,59 $3A,3B 




YREG 


71 


$4 7 








ACC 69 $45 




YSAV 


52 


$34 




fc 


m 


XREG 70 $46 




STATUS 


72 


$48 




F 


<a 
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CHAPTER 4 

MISCELLANY 

MACHINE LANGUAGE DEVELOPMENT AIDS 

There are many routines in the Monitor which can be. helpful when 
developing machine language programs. Some of these are routines to be 
imed in the finished program, like the Monitor HOVE routine. Others 
'11 this- list are general, special, or very special screen output 
i out fnos, and sone data manipulation routines. 

ADDRESS TABLE 



Kunc t ion 



Ilex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Write byte in A to screen at CV,CH. FDKD 
Print carriage return thru COOT. 
Print three blanks thru COUT. 
Print (X) blanks thru COUT. 
Print character in A followed by 

(X)-l blanks. 
Print BELL code thru COUT. 
Print "ERR" and BELL thru COUT. 



Print, low nibble of A as hex chart 

Print A-reg as 2 hex nibbles. 

Print hex of Y,X regs. 

Print hex of A,X regs. 

Print hex of X-reg. 

Print OR, then hex of Y,X regs, 

then minus sign (or dash). 
Print hex of Y,X regs, then dash. 
Print OR, hex of A1H.A1L, and dash. 
Print memory as hex with preceeding 

address from ramnm to mnm7 where 

mmnra is initial content of AIL, II. 
Print memory aa hex from (A1L,H) 

thru (A2L,H). 



FD8E 
F948 
F94A 
F94C 

FF3A 
FF2D 

FDE3 
FDDA 
F940 
P941 
F944 
F096 

FD99 
FD92 
FDA3 



Snv*» A,X,Y,P,S regs at $45-49. FF4A 

Dl splay registers with names from FAT)7 

$'4 5-49 as SAVEd , with preceeding 

rnrriage return. 
Display regs as above without CR. FADA 
Hi'Btnre regs A,X,Y,P not S from S45 FF3F 

Monitor Command Processor GO entry. FKB6 
Set PCI.,11 from AIL, II if entered. & 
Cull RESTORE, set all regs but S.& FEB9 
Jurap via PCI,, II. FEBC 

llovr memory contents to (A4L,H) FE2C 

I 11.111 <AII.,II) thru (A2L,II). 



65(J05 
64910 
63816 
63818 
63820 

65338 

65325 

64995 
64986 
63808 
63809 
63812 
64918 

64921 
64914 
64931 



-531 COUT 

-626 CROUT 

-1720 PRBLNK 

-1718 PRBL2 

-1716 PRBL3 



-198 
-211 



BELL 
PRERR 



-54 1 PRHEX 

-550 PRBYTE 

-1 728 PRNTYX 

-1727 PRMTAX 

-1 724 PRNTX 

-618 PRYX2 



-615 
-622 
-605 



PRA1 
XAM8 



?A 

A 

A,X 

A,X 

A,X 

A 

A 

A 
A 
A 
A 

A 
A,Y 

A,Y 
A,X,Y 
A (Y=0) 



FDB3 64947 -589 XAtl A (Y=0) 



65354 


-1S2 


SAVE 


A,X 


64215 


-1321 


RECDSP 


A,X 


64218 


-1318 


RGDSP1 


A,X 


6534.3 


-193 


RESTORE 


A,X,Y,P 


65206 


-330 


GO 


A,X,Y,P 


65209 


-327 






65212 


-324 






65068 


-468 


MOVE 


A (Y=0) 
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Function 



Compare memory contents (A4L.H) 

to (A1L.H) thru (A2L.H), print 

differences thru COUT. 
Increment A4L.H ($42-43). & 

Increment A1L.H (S3C-3D), set Carry 

if A2L.H less than A1L,H. 
Set GBASL.H for line (A). 
Clear A-reg to a nibble, leaving 

in low nibble entry low nibble if 

entry carry clear, high nibble if 

entry carry set. 
Disassemble the instruction at 

(PCL.H), print thru COUT. 
Compute (PCL.II) + (LENGTH), leave 

results in A,Y. Decimal Mode Flag 

must be clear before calling PCADJ 
Read paddle (X) into (Y-reg). 
Wait .01 seconds, then sound bell. 
Load Y=192 for .1 sec of bell. & 

Toggle speaker at I KHZ for number 

of cycles in Y-reg. 
Place character in screen refresh 

memory if not control character. 

If known control character, do it. 

If unknown control character, RTS. 
Clear window to blank, set cursor 

to top left corner. 
Load into Y, then print dash. 
Print dash thru COUT. 
Character print to screen output 

routine entry - normal for CSWL. 

Print character to screen with 

appropriate actions on controls 

and control characters. 

If (A)<$A0 goto COUTZ, bypass 
inverse video mask. 
Monitor entry on RESET key pressed 

or Power on. 

Call SETNORM - white on black. 
Clear 6502 decimal mode (set hex).& 
Sound bell 
Monitor Command Processor Entry. 

Set "*" as prompt character 

Set (a) as prompt character 
Monitor Command Processor command 

parsing routine; save hex digits 
in A2L,H, return with command 
(first non-hex) in A-reg, Y-reg 
set for next character. 













F 


Hex 
Addr 


+Dec 
Addr 


-Pec 1 
Addr 


ion it or 
Label 


Registers 
Destroyed 


¥ 


FE36 


65078 


-458 


VFY 


A (Y=0) 


¥ 


FCB4 
FCB.A 


64692 
64698 


-844 
-838 


NXTA4 
NXTAI 


A 
A 


¥ 


F847 
F879 


63559 

63609 


-1977 

-1927 


GBASCALC A 
SCRN2 A 


¥ 












¥ 


F8D0 


63696 


-1840 


INSTDSi 


1 A.X.Y 


¥ 


F953 


63827 


-1709 


PCADJ 


A,X,Y 


¥ 



FB1F. 64286 -1250 PREAD A,Y 

FBDD 64477 -1059 A,Y 

KBE2 64482 -1054 A,Y 

FBE4 64484 -1052 BELL2 A,Y 

FBFD 64509 -1027 VIDOUT A,Y 



FC58 64600 -936 HOME 



FD9C 

FD9E 
FDF0 



64924 

64926 

65008 



-612 
-610 
-528 C0UT1 



A,Y 



?A 





FF59 


65369 


-167 


RESET 


& 
& 


FF65 


65381 


-155 


HON 


& 


FF66 


65382 


-154 




& 
& 


FF69 


65385 


-151 


MONZ 


FF6B 


65387 


-149 






FFA7 


65447 


-89 


CETNUM 



AIL, II 60,61 


$3C,3D 


A4L.II 


66,67 


$42,43 


YREC 


71 


A2L.H 62,63 


$3E,3F 


PCL.I1 


58,59 


$3A,3B 


XRF.G 


n 


A3L.H 64,65 


$40,41 


ACC 


69 


S45 







$47 
$46 



¥ 
¥ 
¥ 
¥ 

¥ 
¥ 
¥ 
¥ 
¥ 
¥ 
¥ 



t 

I 

Z 

Z 
Z 
Z 

z 

z 

z 
z 
z 
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c 



LORES PLOTTING 



In standard (or low resolution) plotting mode, the graphic area of the 
ncreen is 40 points wide and either 40 points high with 4 lines of 
ii'Xl below or 48 lines high. The X coordinate is horizontal and the Y 
coordinate is vertical. The same memory area is used for low 
ri'solutton plotting as is used for text output to the screen. However, 
In the graphics mode, each character position contains information for 
l wo plot points, one immediately above the other. Thus, 20 text lines 
arc used to display 40 graphics lines in the mixed mode, and 24 text 
I hies are used to display 48 graphics lines in the full screen mode. 

There are four bits allocated for each point, by means of which the 
point may be displayed in any of 16 colors. 

The Monitor contains routines supporting the following functions: 

Set display mode to mixed graphics and text. 

Clear the graphics part of the screen (in whole or in limited 
part). 

Set a color control byte to be used for each plot point 
established until another color is selected. 

Plot a single point at an indicated vertical /horizontal position. 

Clot a horizontal line from one vertical /horizontal point to a 
vertical value. 

Plot a vertical line from one vertical/horizontal point to a 
vertical value. 

Return to requesting program the color value of the point at a 
specified coordinate. 

TIktc are. limitations on some of these functions which may not always 
In- desirable. For example, using the entry point which sets mixed 
graphics and text includes clearing the graphics part of the screen, 
Ki'ttlng the Scroll Window to be the entire remainder of the screen, 
mid moving the cursor (straight down from current position) to the 
bottom line of the screen. In addition, there is no Monitor entry 
point for setting full screen graphics mode. However, the display mode 
roiitrols are easily set In any desired fashion merely by poking or 
•.I or lug into the appropriate memory locations, so this is certainly no 
mo h>r problem. 

Various page zero locations ore used for low resolution graphics mode. 
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PAGE ZERO FIELDS 

Dec Hex 

Routine Addr . Addr . 

GBASl.,11 38-39 $26-27 



COLOR 48 $30 



MASK 



46 



$2E 



112 



V2 



44 S2C 



45 $2D 



Description 

is set by the GBASCALC routine to the memory 
address of the plotting line specified. 

contains the selected color value in both high 
and low nibbles of the byte. 

is used internally by the plot routines as $F0 
or $$F to set either the high or low nibble of 
tbe receiving byte depending on whether the 
graphics line is the top or bottom of the two 
displayed from that "text" line. 

is the right end point for horizontal line 
drawing. 

is the bottom end point for vertical line 
drawing. 



F 

¥ 

¥ 
¥ 

i 

¥ 
¥ 
¥ 






ADDRESS TABLE 



Funct ion 



Hex +Dec -Dec 
Addr Addr Addr 



Monitor Registers™ 
Label Destroyed 



c 

* 



f" 



;3D 



Plot a point at line (A) col. (Y) 
leaving CBASL.H and MASK set. 

Plot a point, line per GBASL.H 
and MASK, col. in Y. 



F800 63488 -2048 CLOT A 

F80E 63502 -2034 PL0T1 A 



Draw horizontal line at (A) from F819 

(Y) thru (112), left to right. 

Draw horizontal line at line F81C 

indicated by GBASL,H. MASK from 

(Y) thru (H2). 
Plot vertical line at (Y) from F828 63528 

(A) thru (V2). 

Plot vertical line at (Y) from F826 63526 

(A)+1+ C arry thru (V2). 
Plot vertical line at (Y) from F82D 63533 

(A)+l thru (V2). 
Clear full (48 lines) screen. F832 63538 

Clear graphics area (40 lines). F836 63542 

Clear graphics partial from line F838 63544 

thru (Y), 40 col. wide. 
Clear graphics partial from line F83A 63546 

to (V2) 40 col. wide. 
Clear graphics partial, top left F83C 63548 

lines thru (V2),col. thru (Y). 
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63513 -2023 HUNK A,Y 

63516 -2020 HLINE1 A,Y 






-2008 VLIN'K 



-2010 

-2003 

-1998 
-1994 
-1992 

-1 990 

-1998 



VLltffiZ 



CLRSCK 
CI.RTOP 
CLRSC2 



CLRSC3 



A 

A 

A 

A,Y 
A.Y 

A,Y 

A.Y 
A,Y 



:*] 



E 

k 

k 
k 
k 
k 



z 

z 

'I 



Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Set LORES screen to COLOR from top 

left corner to (Y),(V2). 

F.ntry A-reg must be 0. 

F.tHry Y-reg = right column to set. 

Set V2 to last line to set. 
Sot COLOR for following points 

to (A). 
Change COLOR to (C0L0R)+3. 
Load to A color of point (A),(Y). 
Set CHASL.H from A. (A)=line/2. 
Set Color Graphics display mode 

and following are also done; 
Sot graphics mode to Mixed. 
Clear graphics part of screen. 
Load $14 to A for WNCTOP. 
SI ore A to WNDTOP. 
Load to A for VNDLFT. 
Si ore A to WNDLFT. 
Load $28 to A for WNDWDTK. 
Si ore A to VNDWDTH. 
Load $18 to A for WNDBTM. 
Si ore A to WNDBTM. 

Loud $17 to A for CV. 
Co Jo TABV to set BASL.II. 



F840 63552 -1984 



A,Y 



F864 


63588 


-1948 


SETCOL 


A 


F85F 


63583 


-1953 


HXTCOL 


A 


F871 


63601 


-1935 


SCRN 


A 


F847 


63559 


-1977 


GBASCALC 


A 


FB40 


64320 


-1216 


SETGR 


A,Y 


& FB43 


64323 


-1213 




A,Y 


& FB46 


64326 


-1210 




A,Y 


& FB49 


64329 


-1207 




A 


& FB4B 


64331 


-1205 


SETWND 


A 


& FB4D 


64333 


-1203 




A 


& FB4F 


64335 


-1201 




A 


& FB51 


64337 


-1199 




A 


& FB53 


64339 


-1197 




A 


& FB55 


64341 


-1195 




A 


& FB57 


64343 


-1193 




A 


& FB59 


64345 


-1191 




A 



DATA MANUPILATION FUNCTIONS 

There are a number of routines in the Monitor which may be called by 
imcr programs to perforin often needed tasks. The routines described in 
IIiIh section are miscellaneous routines which move data from place to 
place hi' convert the form of information provided to the routines. 
Noli' ttml some of these routines are in both the Old Monitor and the 
AuloMtart Monitor while other routines are in only one or the other. 
Throe address tables are provided; one for both Monitors, one for the 
old Monitor, and one for the Autostart Monitor. 



£H ROUTINES 



Memory to Memory Move 



In '"Hi Ine Is used by the Monitor "M" command. As the Command 
ii-ipieii'i scan:; the keyboard input, fields Al, A2, and A4 are 
ridfd. When I lie Command Interpreter encounters the "M" it calls label 
IUVK, mm Indicated in the table. The contents of memory from locations 
Al) Hun (A2) are moved to memory beginning at location (A4). See the 
.mill I e praKMin In the section "Secondary Display Area Ways and Means" 
i.-i nne <.l MfWK from BASIC, with the assistance of the Monitor CO 
• int Ine lor netting registers on the way in. 
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Jump to Address with Registers Loaded 

The routine in the Monitor which responds to the "G" command uses some 
Monitor routines from BASIC or APPLESOFT in that the registers are 
loaded from the save area and then control is transferred to the 
location specified in PCL,I(. Thus, a BASIC program can set up the 
destination address and register contents, and then CALL -468 to have 
the requested routine entered. This is used in sataple programs in this 
section and in the section on "Secondary Display Areas". 

Increment Address Fields 

The Monitor Move routine described above is a sample caller of the 
NXTM and NXTA1 routines. When NXTA4 is called, It Increments the two 
byte field A4L,H and then falls into label RXTA1. The routine at NXTA1 
increments the two byte field at AlL.H, and then compares that field 
to the two byte field A2L.H before returning to the calling program. 
On return to the calling program, the Carry status bit is clear if 
(A1L.H) is less than or equal to (A2L.I1). Carry is set if (A1L.H) is 
greater than (A2L.H). 



Save 6502 Registers 



The SAVE routine is used by various other Monitor routines to store 
the 6502 registers in page zero locations $45-$49. This routine may 
be called by user program under certain conditions - namely, that 
neither the Monitor nor any other program will be calling SAVE at the 
same time. In the Old Monitor SAVE and RESTORE are used in support of 
Monitor commands S and T, single step and instruction trace. In both 
Monitors, the SAVE routine is called on a BRK interrupt at entry point 
SAV1 as the A-reg is stored at $45 on entry into IRQ interrupt 
processing. 



Restore 6502 Registers 



The routine at label RESTORE is the inverse of the SAVE routine, 
except that the S-reg is not loaded. In the Old Monitor, RESTORE Is 
utilized by instruction step and trace routines before controlled 
execution of each traced instruction. Tn both Monitors, the registers 
are loaded by RESTORE in execution of the Monitor C command before 
transferring control to the operator-indicated location. 



Multiply Two Byte Fields 



The MOT and MULPM routines multiply two byte fields to give a four 
byte product. They exist only in the Old Monitor. If a program (such 
as an assembler) calls MULPM at FB60, and it is executed with the 
Autostart Monitor in the machine, the result is that on each call the 
screen will be cleared and "APPLE II" will he written on the top line. 
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f31 



:3Q 



30 



i* 1 

E 
i 



c 
c 

3D 



f. 



Multiply Routine 

Note in the following that the data fields for multiply and divide are 
in the same format as other multiple byte numbers in the Apple: lowest 
memory address Is least significant byte. 



Sot Multiplier in 
Set Multiplicand in 
Should be zero - see note 



$55,54 (MSB.LSR) 
$51,50 (MSB.LSB) 
$53,52 



Onll/JSR FR60 or FB63 (-1184 or -1181) (MULPM or MUL) depending on 
bIro conventions or requirements. 

The result, in order of most significant to least, is in $53, $52, 
$51, $50. this result is positive. If one of the two input factors 
(but not both) was negative, then SIGN (at $2F) contains an $01 bit, 
Indicating that the result should be complemented by the user program 
before further use. 



NOTE: The table of values above indicates that $53,52 should be set 
to zero before calling multiply. If this is not done, then the initial 
contents of this field will be added to the result. For example, if a 
table has an origin of $8400 with 7 byte long entries, the address of 
entry 8 can be determined by entering the multiply with $8400 in 
$51,52 and the 8 and 7 in position for the multiply. 



Examples: 



Called 
Kout ine 



Inputs 
$51 $50 $55 $54 



Outputs 
$53 $52 $51 $50 $2F 



HTTl.PM— 00 01 00 -0T 

00 01 01 00 

04 00 0S 00 

FC 00 08 00 



FC 0(J 

7F FF 

80 00 

80 00 

00 01 

00 01 

04 00 

FC 00 

FC 00 

00 FC 

80 00 

80 00 

12 34 



F8 00 

7F FF 

02 00 

80 00 

00 01 

0.1 00 



F8 



f'8 



02 00 
80 00 
56 78 



00 20 

00 20 

00 20 
3F FF 

01 00 
40 00 



00 00 

00 20 

07 E0 

F4 20 

00 00 

01 00 
40 09 
06 26 



"P 01 W 
01 00 00 



00 01 



00 01 

01 00 



F4 20 



91 
02 
U 

n 



MISCELLANY 71 



Divide Four Byte Dividend by Two Byte Divisor 

This routine divides a four hyte dividend by a two bit divisor, giving 
a two byte quotient and a two byte remainder. It is available only in 

the Old Monitor. This routine accomplishes the division of the number 
in bytes $53,52,51,50 by tho number in bytes §55, 54, leaving the 
quotient in $51,5(3 and the remainder in $53,52 (most significant to 
least significant). 

If the contents of $53,52 is larger than the contents of $55,54, then 
the result will not fit in the quotient bytes - overflow is the 
result. The calling program must not let this happen. 

With regards to scaling, looking at the four byte dividend as an 
Integer value and the divisor in $55,54 as an integer, the quotient 
and remainder fields are also integers. 

Sign can be a problem if the DIVPM entry point is used. The sign hit 
of the dividend is the $80 bit of byte $51. If the intended divide is 
two bytes (with $53,52 cleared before divide) then signed fields 
division is supported, with the sign bit being the LSB of $2F. If the 
call is to DIVPM, and if $2F contains $01, then complement the results 
before using them. 

When using unsigned divide, entry point DIV, then the divide is 32 bit 
field by 1.6 bit field with 16 bit results. 



Examples : 



Called 

Routine 



Inputs 
Dividend Divisor 



Outputs 

Quotient Remainder 



$53 52 51 50 $55 54 



"551 W 



ign 
$53 52 $2F 



DIVPM 
[$FB81] 
[64385] 
[-1151] 



00 40 00 00 

00 00 00 08 

00 01 00 00 

00 00 00 03 

00 00 30 00 

00 00 30 00 
00 00 33 33 

00 10 40 00 

00 20 80 00 

00 20 ~8T 00 
00 10 41 00 



DIV 

[$FB84] 
[64388] 
[-1148] 



00 04 
00 02 
00 02 
02 00 
20 00 
00 22 
04 00 
08 00 



04 00 
80 00 



08 00 
00 02 
80 00 
00 01 
00 18 

00 01 

01 81 
04 10 
04 10 

04 0F 

04 10 



00 00 
00 00 
00 00 
00 01 
00 00 
10 00 
00 11 
00 00 



06 00 

01 00 



00 

00 

w 
00 

01 

0T 



V 
Y 
Y 
Y 
Y 
Y 
Y 
t 
t 
F 
Y 
Y 
fc 
k 

fe 

I 

y 



'C 

i 

c 

!"i Convert Hex Characters to Value for Use 

r 



I 






Establish a RESET Vector 

The Autostart Monitor supports an address vector for completion of 
handling a RESET interrupt. It is called the Soft Entry vector as it 
Is designed to allow resumption of processing after a RESET. This 
vector is in page three. It contains the address to which control is 
to be transferred after the screen, keyboard, and other basic Apple 
hardware items have been set to their "Initial" states. For example, 
the display hardware is set to display primary area text, and the 
Scroll Window full screen values are set. 

ATter such initialization is performed, locations $03F3 and $03F4 are 
tested against one another to determine whether the vector in $03F2- 
S03P3 is to be considered valid. If so, control is transferred to 
($01F2-03F3). Normally, this results in transfer of control to $E003 
to accomplish the result of entry to the Monitor of a control-C, re- 
entry into BASIC or APPLESOFT. During the bootstrap operation, DOS 
liiBtnlls its own restart point in this vector. And, of course, yoxi may 
wish to set some other value in this vector, such as that which will 
cause the Monitor (with asterisk prorapt) to be called, as was the 
normal case with the Old Monitor. To set a different value in that 
vector, POKE or store the desired value in $03F2-$03F3 and then CALL 
or JSK to SETPWRC ($FB6F or -1169) to have the Monitor set $03F4 
oppropr lately. 



Programmer utility programs often need input of address or data in hex 
Hither than in decimal. The Monitor also uses input in hex, and 
therefore has a way of converting input hex characters to a value in a 

I leld. The GETNIIM routine in the Monitor converts characters from the 
keyboard input area ($0200-$02FF) to hex stored in A2L.1I and 
conditionally in A1L.H and A3L.H. 

The KKTNliM routine converts characters in the $0200 area beginning at 
'H;>00+(y-reg) and continuing until a character la found which is not a 
licx riioil (not 0-9 or A-F). The result in A2L.H (and A1L,H and A3L.11 

II (MODi:) (J) is the last four hex digits in the string converted if 
(lie Hiring Is more than four hex digits. If the string is fewer than 
foni hex digits the result field contains the value right adjusted 
wlili lending zeroes. A sample program is provided at the. end of this 
i.e< I /on showing use of CETNlfM from APPLESOFT. 



Disassemble an Instruction 

The Apple II Monitor contains a disasserobler by means of which one can 
illii.pl ny ji porl Ion of a machine language program in mnemonics instead 
'•I liitit hex. At label LIST (SFE5E) is the routine to which control is 
|>fi*Hcd wh'-n the Monitor command "L" is used. This routine sets a 
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counter to 20, and then calls the single instruction disassembler 20 
times, with appropriate adjustment of the instruction pointer PCL, II. 
This routine can be used as an example of how to use the locations in 
the address table with labels INSTDSP and PCAD.I. 

The routine at INSTDSP uses the INSDS1 routine to set the zero page 
locations FORMAT and LENGTH appropriately for the instruction at 
(PCL.H). INSDS1 also prints to the screen the contents of PCL.H, the 
address of the instruction to be disassembled. On return from INSDS1, 
the INSTDSP routine controls the printing of che rest of the 
disassembly line. 

Note that PCI,,H is not altered by disassembly of the instruction. 
Thus, it must be "maintained" by the program which calls INSTDSP. 
This is accomplished by calling the PCADJ routine, which returns the 
new values to the calling program, to store into PCL and PCH in the 
A-reg and Y-reg, respectively, having computed the new value from PCI, 
and PCH and LENGTH (set by INSDS1). 



ADDRESS TABLE 



Function 



Hex +I)e.c -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



OLD MONITOR ONLY 
Multiply signed fields leaving 
sign in LSB of SIGN. 

Multiply fields unsigned, 
(51,50) * (55,54) = (53,52,51,50). 



F560 6A352 -1184 MULPM 
FB63 64355 -1181 MUL 



Divide signed fields leaving sign FB81 64385 -1151 DIVPM 
in SIGN LSB (from 51,55). 



Divide unsigned fields 
(53,52,51,50)/(55,54)=(51,50). 

Set absolute values for ACL,H and 
AUXL.H leaving resulting sign in 
LSB of SIGN (called by MULPM and 
DIVPM) . 



FB84 643J 



-1148 DIV 



FBA4 64420 -1116 HDJ 



A,X,Y 
A.X.Y 
A,X,Y 
A,X,Y 
A,X,Y 



AUTOSTART MONITOR ONLY 

Set validity of RESET vector. 



FB6F 64367 -1 16V SETPWRC 



BOTH OLD AND AUTOSTART MONITORS 

Monitor Command Processor GO entry. FEB6 65206 -330 

Set PCL.H from AIL, 11 if entered. & 

Call RESTORE, set all regs but S.& FEB9 65209 -327 



GO 



A,X,Y,P 



Jump via PCL, II. 
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Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Move bytes in memory to (A4L,H) 
from (AIL, II) thru (A2L.H). 
Note: Y-reg must be zero on entry. 

Increment pointer A4L,H. & 

Increment pointer A1L,H with set 

of carry if resulting (A1L,H) is 

greater than (A2L.H). 

Save 6502 regs A,X,Y,P,S at 
$45-$49. 

Restore 6502 regs A,X,Y,P from 

$45-548. 

Convert hex characters from 
$200»Y to value in A2L.H (and 
ML, II and A3L.II if (MODE)=0). 

1)1 HiiMtfomble one instruction with 
display thru COOT. 

Compute new PCL, II after disassembly 
>>i" i race or step - return results 
In A,Y regs for (PCL, II). 



FE2C 65068 -468 MOVE A 



FCB4 64692 -844 NXTA4 A 

FCBA 54698 -838 NXTA1 A 



FF4A 65354 -182 SAVE A,X 

FF3F 65343 -193 RESTORE A,X,Y,P 

FFA7 65447 -89 CETNUM A,X,Y 

F8D0 63696 -1840 INSTDSP A,X,Y 

F953 63827 -1709 PCADJ A,X,Y 



APPLESOFT SAMPLE DATA MANIPULATION PROGRAM 



10 
20 

10 

1 



3 10 

220 

? 10 

240 
250 

/I.0 

2 70 
2H0 

m 

100 

110 
l. J 
I 10 

140 



GOTO 

POKE 
POKE 

siS ■ 

FOR I 

ccS - 
<XX - 

HIKE 
NEXT 
POKE 
POKE 
CALL 



REM 
REM 
REM 
REM 
W0: 

REM 

58,167: 

59,255: 

AD? + 

- 1 TO 

MIDS 

ABC ( 

512 + I 

71, Li 



DATA MANIPULATION FUNCTIONS 

SAMPLE PROGRAM 
MEMORY DUMP 
OF HEX .AREA INDICATED. 

REM BYPASS SUBROUTINES 
CALL GETNUM ROUTINE VIA GO ROUTINE 
REM PCL=$A7 
REM PCII=$FF 
' ": REM BUILD STRING TO STORE 



LEH (SI$) 

(sis, i,i) 

CC$) + 128 
,CC% 



REM 
REM 
REM 



STORE STRING IN INPUT BUFFER 



REM SET lR.EC TO START AT LOCATION 513 



49,0: REM CLEAR MODE BYTE 

- 32 7: REM GO PROCESSOR 

ST PEEK (62) + 256 * PEEK (63): REM 

IF ST > 3276 7 THEN ST = ST - 65536 REM 

RKTIIRN 



ST=START ADDRESS (SA2) 
TWO'S COMPLEMENT 
ADDRESS IF >= $8000 
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600 

610 

620 

630 

640 

650 

660 

670 

680 

690 

700 

710 

720 

730 

740 

750 
760 

770 

780 

790 

1000 

1010 

1020 

1030 

1040 

1050 
1080 

1090 
1100 
1110 
1120 
1130 



REM DISPLAY HEX CONTENTS 
SH% - ST / 256 REM GET HI ADDRESS BYTE 

SL% = ST - SH% * 256: REM GET LO ADDRESS BYTE 
IF SHX < THEN SH% + 256: REM GET 2'S COMP IF NECESSARY 

POKE 60,SL%:POKE 6l,SW% 

RM% = SL% - ( INT (SU / 8 )) * 8 REM RM% = MOD 8 OF 1.0 BYTE 

IF RMZ THEN CALL -622 

POKE 71,0: REM SET "Y" REG TO ZERO 



POKE 58,163 

POKE 

CALL 



REM 
REM 
REM 

PRINT 



PCL = $A3 

PCH = $FD 

CLEAR "Y" REG & $FDA3G 

! "; : REM SEPARATES HEX FROM ASCII 



59,253 

- 327 

POKE 36,29: 

REM DISPLAY ASCII CHARACTER CONTENTS 
SE = ST + 7 - RM% REM SEPARATES HEX FROM ASCII 
FOR I = ST TO SE REM PRINT ASCII CONTENTS 
CX = PEEK (I): IF CX < 128 THEN CX = CX + 128 
CX$ = CHR$ (CX): IF CX < 160 THEN CX$ = "?" 
PRINT CX$; 
NEXT 
RETURN 

REM PROGRAM START 
PRINT "HEX DISPLAY" 
INPUT "ENTER ADDRESS ";AD$ 
IF AD$ = "END" THEN END 
IF LEN (AD$) = THEN 11 



:REM CONTINUE UITH NEXT AVAILABLE 
ADDRESS 



GOSUB 200: 

FOR .1 = 1 TO 16: 

GOSUB 600 

ST = ST + 8 - RM% 

NEXT 

PRINT 

GOTO 1020 



REM PRINT 16 LINES 



MONITOR COMMAND PROCESSOR 

The Monitor Command Processor is that part of the Monitor which 
responds to commands entered with the "*" prompt character. These 
commands include data movement from one location to another, cassette 
tape reading and writing, instruction disassembly, and others 
described in the Reference Manual. The Reference Manual contains a 
complete description of use of these commands. This section of this 
manual describes calling some of the routines from a user program 
instead of from the keyboard, and .lumping into the Monitor with no 
return to the user program. 

ENTERING THE MONITOR COMMAND PROCESSOR 

The Monitor Command Processor is that part of the Monitor which reads 
keyboard input with the asterisk prompt character and performs the 
requested service. "Entering" the Command Processor implies turning 
over control of the machine to the Monitor Mode. When the RESET key is 
pressed with the Old Monitor in the Apple the. computer is placed in 
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Monitor Mode. When the RESET key is pressed with the Autostart Monitor 

in the machine, the computer generally goes into BASIC or APPLESOFT. 
With the Autostart Monitor the only way to get into Monitor Mode is to 
CALL one of these entry points (generally CALL - 151). 

In this mode, data may be moved in memory using the Monitor Move 
command. Blocks can be read from tape via the cassette tape data 
transfer commands. Or any of the other Monitor commands may be used. 
However, having entered Monitor Mode, the Monitor Command Processor is 
reading the commands from the keyboard and then acting upon them. 

There are a number of entry points indicated in the address table for 
"entering" the Monitor Command Processor. Please note that once the 
Monitor is jumped to at the specified point, all of the initialization 
described after that entry point is also performed. This is implied by 
t lie "&" at the end of each function description. 

CALLING THE MONITOR COMMAND PROCESSOR 

"Calling" the Monitor Command Processor implies that return will take 
place to the calling program. However, the driver part of the Monitor 
Command Processor is not designed to operate in that fashion, so a 
iihort machine language, program is required to allow exit back to the 
calling program. A sample program is provided at the end of this 
section indicating the required setup. In the sample, the. three byte 
machine language routine is placed in page two (at $02FC) but it may 
he placed anywhere desired. With this program, Monitor calls from 
I1ASIC or APPLESOFT are both supported. 

A program which CALLs the Command Processor must first store the three 
hyli' exit routine somewhere. Then the program can POKE a string of 
Monitor commands into the input area, beginning at address $0200, the 
Inst command of each such string being a Monitor GO command to 

transfer control to the exit routine. In the sample, the last Monitor 
command in the string is "02FCC". The function of the exit routine is 

to |Ki II one return address level (two bytes) off of the stack, and 
i her do an RTS to return to the BASIC, APPLESOFT, or machine language 
i-a I 1 1 ng program. 



ADDRESS TABLE 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Monitor Command Processor, "blank" FE00 65024 -512 BL1 A,X,Y 

ctii rv point used for CR. 
Monitor Command Processor, "blank" FE04 65028 -508 BLANK A,X,Y 

riHiniiand entry point. 
Mom I lor Command Processor, Store FE0B 65035 -501 STOR A 

rout i nc . 
Monitor Command Processor, set FE18 65048 -488 SETMODE A,Y 

MODE lor colon, period, plus, or 

ml mis . 
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Funct ion 



Store appropriate value to MODE, 

entered from BLANK also. 
Monitor ConKand Processor routine 

for less than (<) command , 
Monitor Command Processor MOVE 

routine. (AlL.H) thru <A2L,H) is 

moved to (A4L,H) thru whatever. 
Monitor Command Processor VERIFY 

routine. (AIL, If) thru (A2L,H) is 

compared to (A4L,H) thru whatever 

with differences printed thru COUT 
Monitor Command Processor LIST 

(disassembler) routine: list 20 

instructions thru COOT. 
Set INVFLC to $3F = inverse video. 
Set INVFLG to SFF = normal video. 
Set INVFLG frcm Y-reg. 
Set port (keyboard) for input. 
Set port (A) for input. 
Set port (A2L) for Input. 
Set port (screen) for output. 
Set port (A) for output. 
Set port (A2L) for output. 
Monitor Command Processor CO entry. 

Set PCI..H from A1L,H if entered. & 

Call RESTORE, set all regs but S.& 

Jump via PCL.H. 
Monitor Command Processor Display 

Register contents. 
Monitor Command Processor Carriage 

Return entry. 
First, simulate entry of blank. 
Then POP 2 from stack, and goto 
Monitor Command Processor at MONZ 
Restore registers from $45-49: 

Load STATUS and push to stack. 

Load A from ACC. 

Load X from XREG. 

Load Y from YR£C. 

Load P from stack (PLP) and RTS. 
Save 6502 regs at $45-49. 

Save A-reg at ACC $45. 

Save X-reg at XREG $46. 

Save Y-reg at YREG $47. 

Save P-reg at STATUS $48. 

Save S-reg at SPNT $49. 

Clear 6502 decimal mode (set hex). 



Hex 


+I)ec 


Addr 


Addr 


FE1D 


65053 


FF.20 


65056 


FB2G 


65068 



-Dec Monitor Registers 
Addr Label Destroyed 



-4S3 SETMD7. none 

-480 LT A,X 

-468 MOVE A (Y=0) 

FE36 65078 -458 VFY A (Y=0) 



FE5E 65118 -418 LIST 



A,X,Y 



FE80 


65152 


-384 


SETINV 


Y 


FF84 


65156 


-3S0 


SETNORM 


Y 


FE86 


65158 


-378 


SETIFI.G 


none 


FE89 


65161 


-375 


SF.TKBD 


A,X,Y 


FE8B 


65163 


-373 


IMPORT 


A,X,Y 


KE8D 


65165 


-371 


ItlPRT 


A.X.Y 


FE93 


65171 


-365 


SETVID 


A,X,Y 


FK95 


65173 


-363 


OUTPORT 


A,X,Y 


FE97 


65175 


-361 


OUTPRT 


A,X,Y 


FEB 6 


65206 


-330 


GO 


A,X,Y,P 


FEB 9 


65209 


-327 






FEBC 


65212 


-324 






FEBF 


65215 


-321 


RECZ 




FEF6 


65270 


-266 


CRMON 





FF3F 
& 
& FF42 


65343 


-193 


RE STORK 


65346 


-190 




& FF44 


65348 


-188 


RF.STR1 


& FF46 


65350 


-186 




FF48 


65352 


-184 




KF4A 
& 
& FF4C 


65354 


-182 


SAVE 


65356 


-180 


SAV! 


& FF4E 


65358 


-178 




& FF50 


65360 


-176 




& FF54 


65364 


-172 





5 

Z 
Z 
Z 



!<1 



f 

\ 

\ 

\ 



z 

z 
z 
z 
z 

Z 

z 
z 
z 
z 
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Function 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



Monitor entry on RESET key pressed 
or Power on. 

Call SETNORM - white on black. & 
Call IN IT - Text + full scroll. & 
Call SETVID - screen as output. & 
Call SETKBD - keyboard = input. & 

Clear 6502 decimal mode (set hex).& 

.Sound bel 1 . & 

Monitor Command Processor Entry. 
Set "*" as prompt character. & 

Set (A) as prompt character. & 

Call GKTIJJZ to read command line. & 

Clear MODE before scanning line. & 

I' Ick up one command: 
Call GETNUM to scan input line, 
saving hex digits in A2L,H, and 
returning with non-hex in A-reg. 
Save Y at YSAV - current place in 
command line. 

Gall routine indicated by non-hex 
returned by CETNUM. 

On return from Monitor Command 
Service routine, reload Y from 
YSAV and goto NXTITM to process 
next command in the line, if any. 

Monitor Command Processor command 
parsing routine; save hex digits 
in A2l,,H, return with command 
(llr«t non-hex) in A-reg, Y-reg 
set for next character. 

(.'all routine indicated by command 

character : 
Push address $FF.xx onto stack. 
Pass (MODE) to called routine in 

A-reg. 
Clear MODE before call. 
Call ho lee ted routine by RTS. 
Clear MODE byte between commands. 

01,1) MONITOR ONLY 

Execute instruction at (PCL,H), 

wlili display of instruction and 

rcmil t refti sters. 
Mon 1 1 c>r Command Processor TRACE 

Instructions routine. 
Monitor STEP one instruction. 



FF59 65369 -167 RESET 



FF5C 
FF5F 
FF62 
FF65 
FF66 
FF69 

FF6B 
FF6D 
FF70 
FF/3 



FF82 
FF85 



65372 
65375 
65378 
65381 
65382 
65385 

65387 
65389 
65392 
65395 



65410 
654 1 3 



-164 
-161 
-158 
-155 
-154 
-151 



MON 



HON/, 



-149 
-147 
-144 
-141 NXTITM 



-126 
-123 



FFA7 65447 -89 GETNUM 



FFBE 65470 -66 TOSUB 



FFC7 654 79 -57 



ZMODK 



FA43 64067 -1469 STEP 

FEC2 65218 -318 TRACE 
FEC4 65220 -316 STEPZ 



All. ,11 60,61 $3C,3D 

A2I.,II 62,63 $3E,3F 

A 'II. ,11 64,65 $40,41 

A4I..II 66,67 $42,43 

YSAV 52 $34 



PCL.H 58,59 $3A,3B 

ACC 69 $45 

XREG 70 $46 

YREG 71 $47 
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APPLESOFT SAMPLE PROGRAM 

1 REM MONITOR COMMAND PROCESSOR SAMPLE PROGRAM 

10 AA$ = "2FC:68 68 60 N 2FCG ": REM SET UP RETURN ROUTINE P2FC 

11 GO SUB 1000 : REN MOVE COMMAND TO KEYBOARD INPUT AREA 

100 REM RETURN IS SET. NOW CALL 

102 REM SOME MONITOR COMMANDS. 

2 10 AA$ = "F800L 100. IFF 2FCG " 

120 CALL - 936: REM CLEAR THE SCREEN 

130 GOSUB 1000: REM DO DISASSEMBLY, MEMORY DISP1JVY, RETURN 

140 PRINT : PRINT t 

141 PRINT "THATS ALL. " 
1 50 END 

1000 B = 511: REM FOR LOOP IS 1 TO LIM, SO B=BYTE BEFORE $200 

1005 LIM = LEN (AA$) 

1010 FOR I = 1 TO LIM 

1020 PS = MID$ (AAS.1,1) 

1050 P = ASC (PS) + 128 

1070 POKE B + I,P 

1080 NEXT 

1085 CALL - 144 

1090 RETURN 

SPEAKER USE THROUGH THE MONITOR 

There are many ways to use the speaker in the Apple II. One of these 
ways is to signal program events. The Monitor contains a routine which 
supports this use by toggling the speaker at 1 khz for .1 second. This 
is the "beep" heard when the RESET key is pressed or at completion of a 
tape record read or write. 

The Apple II does not contain the only speaker in town. That is, some 
printers which attach to the Apple II make a sound of some type when 
presented with the BELL code. On the Apple II keyboard this is the 
control-G. The character code is $87 or decimal 135. "Printing" this 
character through COUT will cause the Apple to beep, and will cause a 
printer "bell" to sound if there is one. 

There are two ways for a user program to call the routine in the 
Monitor which responds to output of $87 by sounding the beep. 

If you intend to sound the bell in the Apple regardless of 
output device in use, then directly call the routine in the 
Monitor which produces the sound; CALL -1059 (or CALL 64477), 
or JSR FBDD expecting destruction of the A- reg and Y-reg. 

If you want to sound the bell of the Apple II if the screen is the 
print device, or to sound the speaker In the printer, call the 
entry point in the Monitor which places a $87 in the A- reg and 
"prints" it through COUT; CALL-198 (or CALL 65338) or JSR FF3A 
expecting destruction of the A-reg. 
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ADDRESS TABLE 



Funct Ion 



Hex +Dec -Dec Monitor Registers 
Addr Addr Addr Label Destroyed 



TT (A)=$8/ wait .101 seconds, then 

sound the "bell". Else, RTS. 
Walt .01 seconds, then sound bell. FBDD 
Load Y - 192 for .1 aec of bell. & FBE2 
Toggle speaker at 1 KHZ for number FBF.4 

of cycles in Y-reg. 
Print thru COUT "ERR" and bell code.FF2D 
Print bell code ($87) thru COUT. FF3A 



FTO9 5W73 ^TWi BELLI" 



64477 
64482 
64484 

65325 
653 38 



-1059 
-1054 
-1052 

-211 

-198 



BELL2 

PRERP. 

BELL 



A.Y 

A,Y 
A,Y 

A 
A 



CASSETTE TAPE INPUT AND OUTPUT 

There are two primary entry points in the Monitor with regard to 
rending and writing tape. They are READ and WRITE. The requirements for 
Culling these are described below. There are a number of other routine 
entry points which are used by the Monitor on bit and byte basis. These 
arc described below to the extent of location in the Monitor and 

Indication of which Apple II programs call them, but the precise 
Minings of instructions between consecutive calls is beyond the scope 
u/ I hi k manual . 

An you will have found by now, some tape files are conposed of one 
r ncard, and some of two recordS4 For example, LOAPing an APPLESOFT or 
BASIC program results in two beeps, signaling the completions of the 
i.'ikIk of two separate records from the tape. 

definitions are in order: 

A tape re-cord is a single contiguous string of bits which is read 
Into or written from memory as a unit. A tape record is a 
physical entity. 

A file on tape is a series or sequence of one or more records 
containing data in a logical organization. A file is a logical 
■ ■Hi I ly. 

An AITLE.sni'T or BASIC program file consists of two records. For BASIC, 

lh«' firm "I these records is two bytes long, and contains the length 

Hi i In- hi-coihI record. When the Monitor has satisfied BASIC'S read of 
i in' ft rut record, BASIC uses the record length indicated in that record 

in determine the start and end points in memory into which the Monitor 
will rend the second record. Each call to READ or WRITE in the Monitor 
'ir rump 1 I mIm-s only one record input or output. 

M'l'I.KSOFT programs are also SAVEd as two record sets or files. However, 

I li«< firm record is three bytes long; the first two bytes indicate the 
length, nnd the third byte is set to $55 to Indicate a normal APPLESOFT 

II (ur, differentiated from APPLESOFT I) program. 
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Some other programs write a longer (but fixed length) first record 
containing length of the second record of the file, and other infor- 
mation about the file such as date of creation or name of the file. 

WRITE 

$FECD 65229 -307 

Before entry at this point, set the first hyte address in A1L,H ($3C- 
3D) and the last byte address at A2I..H ($3K-3F). The Monitor will write 
ten seconds of continuous tone (header) followed by the contents of 
memory as specified, followed by one byte of checksum (the result of 
Exclusive OR of all the data bytes written to the tape). 

READ 

SFEFD 65277 -259 

Before entry at this point, place the first byte address into A1I.,H 
($30-3D) and the last byte address into A2L.H ($3E-3F). The Monitor 
reads the data from the tape, storing it into nemory in the specified 
locations, and maintaining a running Exclusive OR result in the zero 
page field called CHKSUM ($2E). When the last specified memory location 
has been filled from the tape, the Monitor reads one more byte and 
compares it with the contents of CHKSUM. If equal, the Monitor sounds a 
beep and returns to the calling program. If not equal, the Monitor 
prints "ERR" through COUT before sounding the beep and returning. 

If you want to have the calling program determine whether the tape was 
read successfully or not, then some special actions must be taken. One 
method is to compare the contents of CH ($24) before the tape read with 
the contents after. If they are equal, ERR was not printed to the 

screen. If the cursor horizontal position (CH) has changed across the 
call to READ, then ERR must have been written to the screen. If this 
condition is encountered, the program can then ask the operator to 

position the tape and signal the program for another attempt at reading 

the record. Caution: If CSWL.H points to a printer card or other 

routine which does not output to the screen, CH will not be incremented 
by the output of "ERR". 

CASSETTE INPUT/OUTPUT INTERNAL ROUTINES 

The following entry points/routines functions are described , but not 
docuraented in sufficient detail for call by user program. For some of 
them, timing is critical and the documentation for using them would 
depend on how they were to be used. 
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HEADR 



SKCC9 64713 



-823 



Tills routine writes the synchronization monotone which is the first 
part of every tape record. When the WRITE routine calls HEADR, it loads 
a $40 into the A-reg causing a 10 second header to be written. The READ 
routine also calls HEADR to delay from first detection of data coming 
in from the tape to the first point at which reading for 0/1 detection 
begins. READ loads the A-reg with a $16 before calling HEADR so the 
delay for hardware settling is set to about 3.5 seconds. This routine 
Is not called by BASIC or APPLESOFT, but it is used by the Programmer's 
Aid ill Tape Verify routines which read the tape and compare the data to 
memory instead of storing the data Into memory. 



RD2BIT 



$FCFA 



64762 -774 



This routine causes looping with decrementing of the Y— reg until the 
hardware has indicated two transitions of the tape input register. The 
routine RDBIT is called twice for this purpose. Contents of the Y- reg 
on return compared with contents on entry indicate the length of tine 
I i took for the transitions. 

This routine is called from within the Monitor by the READ routine, to 
delay entering data transfer mode until tape input is available. READ 
culls HEADR for the 3.5 second delay on return from its call to RD2BIT. 

Tills routine is also called from APPLESOFT and from the Tape Verify and 

Shape Table Load programs in the Programmer's Aid #1. 

RDBIT 

SFCFB 64 765 -771 

This routine loops with decrementing of the Y— reg while testing the 
tape Input register for transition from zero to one or one to zero. Bit 
value of zero or one is then determined from the residual count in the 
Y-r.-g. This routine is called from within the Monitor routines RD2BIT 
mid READ. It Is also called by Programmer's Aid ffl Tape Verify. 



RDBYTE 



SFCKC 



64 748 



-788 



'I'h I. 'i routine calls RD2BIT as required in order to assemble a byte of 
Informal Ion from the tape. It then returns to caller with the byte in 
flu- A-i'i'} 1 ,. In addition to being called from the Monitor READ routine, 
ii La ,i1k<> called by Shape Table Load in Programmer's Aid #1. 
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WRBIT 

S FCD6 6472 6 -81(8 

Tills routine accomplishes writing a bit to the tope when called by 
either the 11KADR routine or the WRBYTF, routine. 



WRBYTE 

SFEED 63261 



-275 



When called to write a byte to the. tape, this routine uses WRBIT to 
write ten bits to the tape. The only caller is WRITF. in the Monitor. 

PADDLES, BUTTONS & ANNUNCIATOR I/O 

The Apple II has a Game I/O connector with hardware support for four 
digital outputs, three digital inputs, and four analog inputs (called 
paddles). The Monitor reads the paddles by writing a strobe to start 
the paddle timer and then reading the selecced paddle timer and 
incrementing the Y-reg until that timer comes true. The result of the 
read is in the Y-reg. Monitor support for digital outputs or digit 
inputs is not required. Access to the digital I/O ports is gained by 
PEEKing or POKEing the appropriate address, or by LDx or STx if 
machine language is used. The Autostart Monitor does initialize the 
digital output ports (annunciators) on any RfiSET key interrupt. AN0 
and AN1 are initialized to the clear (TTL IX)) condition by reference 
to addresses $C058 and SC05A. AN2 and AN3 are initialized to the set 
(TTL HI) condition by reference to addresses SC05D and $C05F. 

To use the Monitor support to read the setting of a paddle, JSR to 

PREAD FB1E 64286 -1250 

with paddle number (0-3) in X-reg, and on return the "value" of the 
paddle will be found in the Y-reg. Tine A-reg is destroyed in the 

process. (APPLESOFT and BASIC support paddle reading, so setting of X 
and looking at Y is not required there.) 

Direct reading of the paddles may be accomplished by accessing the 
paddle trigger to start all paddle timers and then reading the 
appropriate paddle input address repeatedly while counting until the 
value read from the paddle address no longer has the $80 bit set. 

CAUTION: After reading a paddle, let some time go by before reading 

another paddle or incorrect results may be a problem. When the paddle 
trigger is strobed, all the timers start. If the first paddle you 

read has a low value, on going back quickly to read another paddle 
the transition you see may be from the first paddle trigger instead 
of the second. See the sample program in the section "Use of 
Control-Y with Parameters". Another solution is to do a read of a 
fake paddle between real readings. 
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GAME I/O HARDWARE ADDRESS TABLE 



Game 1/0 Hardware Address 



Hex +Dec 
Addr Addr 



-Dec 
Addr 



Action/Comments 



Start Paddle Timers 




C07F 


49264 


-16272 




Paddle timer. 




C064 


49252 


-16284 


Negative until 


Paddle 1 timer. 




C065 


49253 


-16283 


timer 


Paddle 2 timer. 




C066 


49254 


-16282 


expires. 


Paddle 3 timer. 




C067 


49255 


-16281 




Paddle y switch. 




C061 


49249 


-16287 


Negative 


Paddle 1 switch. 




C062 


49250 


-16286 


indicates 


Paddle 2 switch. 




C063 


49251 


-16285 


button pushed . 


Clear Annunciator 


output . 


C058 


49240 


-16296 


POKE/STore 


Set Annunciator 


output . 


C059 


4924! 


-16295 


zero 


Clear Annunciator 1 


output . 


C05A 


49242 


-16294 


to 


Set Annunciator 1 


output . 


C05B 


49243 


-16293 


appropriate 


Clear Annunciator 2 


output • 


C05C 


49244 


-16292 


address. 


Set Annunciator 2 


output . 


C05D 


49245 


-16291 




Clear Annunciator 3 


output . 


C05E 


49246 


-16290 




Set Annunciator 3 


output • 


C05F 


49247 


-16289 




WAIT ROUTINE 











The WAIT routine consists of a loop within c loop, constructed in 
such a manner that the length of time spent in the loop varies 
geometrically with the entry A-reg. A call to this routine will cause 
a loop for a predictable length of time, such as is used by the 
Monitor with regards to using the speaker as a bell. It may be 
usable, for example, in writing data to a lower speed device like a 
printer or a typewriter. 



WAIT 



$FCA8 



64 ( 



-856 



Anaylsis of the code indicates that the time between the call WAIT 
(JSR) and the end of the RTS of WAIT is approximately 

2.5A**2 + 13. 5A + 13 machine cycles of 1.023 microseconds, 
where A equals the contents of the accumulator. 



An alternative formula is 

TIME IN MICROSECONDS - (2.5 * 

where A *■ contents of accumulator 
MC = 13 machine cycles 
MS = 1.023 microseconds 



(A~2) + 13.5 * A + MC) * MS 



The following table Indicates delay times in the WAIT routine for a 
number of values of the A-reg on entry. 
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WAIT ROUTINE DELAY TIMES 



A-reg Time in 
(Dec.) seconds 



A-reg Time in 
(Dec.) seconds 



A-reg Time in 
(Dec.) seconds 



17 
18 
19 

25 
26 

31 
32 

36 
37 

41 

42 

45 
46 



.000029667 

.00005115 

.000077748 

.000109461 

.000146289 

.000188232 

.00023529 

.000287463 

.003344751 



37195 

.001090518 
.001 198956 

.001956999 

.002101242 

.002899182 
.003074115 

.003824997 
.004025505 

.004878687 
.00510477 

.005813709 
(1252 



49 
50 

53 
5'. 
55 
56 
57 
58 
39 

60 

73 
74 
75 

85 



96 
97 

105 

106 

122 
123 



.006830571 
.007097574 

.007929273 
.008216736 
.008509314 

.008807007 
.009109815 
.009417738 
.009730776 

.0 10048929 

.014650383 
.015040146 
.015435024 

.029665129 
.020116272 

.024909027 
.025416435 

.029659839 
.030213282 

.03976401 
.040404408 



137 
138 

150 
151 

162 
163 

174 
175 

184 
185 

195 
196 

204 
205 

218 
219 

239 

240 

255 



.049907055 
.050624178 

.059628624 
.060412242 

.06936963 

.070214628 

.079847196 
.080753574 

.089141151 
.090098679 

.099955284 
. 1W969077 

.109263561 
.110323389 

.12456661S 
.125698056 

.149400966 
.150639819 

.169836414 



USE OF CONTROL-Y WITH PARAMETERS 

In the APPLESOFT manual there is a caution that if one paddle is read 
another should not be read too quickly. Following is a machine 
language program with which the interference hetween the paddles can 
he demonstrated. 

Initiate this program by entering the Monitor command xxxxY, where 
xxxx is a number representing the amount of delay to use between 
reading paddle and reading paddle 1, and Y represents control-Y. 
The Monitor command "control-Y" causes a JMP to location $03F8 at 
which location we place a JMP to the beginning of the program. 

As the Monitor scans the input command line, the value of the hex 
digits is placed in page zero locations A11..H ($3C-3D) for our use. 



86 MONITORS PEELED 



y 

¥ 

I 

ft 
I 
I 
I 
f 
I 
I 
I 
I 
I 
\ 
\ 
\ 
\ 
\ 
\ 
\ 



"i 
<i 

4 

n 

4 

4 
4 
*i 

4 
4 
4 

<4 
4 

4 
4 

4 
4 
4 

4 

!«1 



PADDLE INTERFERENCE-SAMPLE PROGRAM 



* !*l 



l 



03F8 JMP $2000 



2000 LDA 

2002 STA 

2004 LDA 

2006 STA 

2008 LDA 

2 00 A STA 

200C LDA 

200E STA 

2010 LDA 

20 1 2 STA 

2014 LDX 

2016 JSR 

2019 STY 



20 2 A LDA 

202C JSR 

202F LDA 

2031 JSR 

2034 LDA 

2036 JSR 

2039 JSR 

20 3 C INC 

203F. BME 

2040 INC 
2042 BNE 



$#C0 

S4 

$3C 

$10 
$3n 

$11 

$10 
$12 

$11 

$13 

$»9 

SFB1E 

$0 



201B DEC $12 

201D BNE $20 IB 

20 IF DEC $13 

2021 BMI $201B 

2023 LDX $#i 

2025 JSR $FB1E 

2028 STY $1 



$0 
SFDDA 

$ltA<fi 

$FDED 

$1 

$FDDA 

$F948 

$5 
$203C 

$4 
$200C 



2044 LDA $#0 

2046 STA $4 

2048 STA $5 

204A INC $4 

204C BNE $204A 

204E INC $5 

2050 BNE $204A 

2052 JSR $FC58 

2055 LDA $lPC0 

2057 STA $4 

2059 BNE $200C 



Set counter for 64 samples to run 
before clearing screen and starting over. 

Pick up low part of entered count frorc AIL 
and store it for repeated use. 

Pick up high part of entered count from All! 
and store it for repeated use. 



Pick up low part of count: 
store it in counter for thi 
and also high part. 



s pass, 



Set X for paddle read. 

Call paddle read. 

Store paddle result in location 0. 

Count down delay loop low byte: 
when zero, count down high byte. 

Stay in the loop until high goes minus. 

Set X for paddle 1 read. 

Call paddle read. 

Store paddle 1 result in location 1. 

Pick up paddle value. 
Print it as a hex value. 
Pick up a blank to print. 
Print the blank. 
Pick up paddle 1 value. 
Print it as a hex value. 
Print three blanks. 

Delay for awhile to keep paddle 1 read 
from upsetting paddle resvilts. 

Is it time to clear screen and restart? 
NE means no, go back and sample again. 

Wait a while before clearing screen. 



Clear the screen. 

Restore the per screen counter, 

and go one more big round. 
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REGISTERS FOR BASIC MONITOR CALLS 

Many of the entry points specified in this book require presetting of 
registers for proper operation. Following is a sample program, 
written for APPLESOFT, which uses Monitor calls for conversion from 
decimal to hex. 

The theory behind the operation is that on a Monitor G command, the 
registers are loaded from the SAVE area before going to the location 
specified in PCL.H. Thus, by poking destination address into PCL.H 

and the required register contents into XREG, YREG, an entry point in 
the Monitor Go command processor can be used to pass the registers to 
a selected routine. 

DECIMAL TO HEX CONVERSION 

APPLESOFT SAMPLE PROGRAM 



10 REM CONVERT DECIMAL INPUT 

100 INPUT "ENTER NUMBER ";A 

110 IF A=99999 THEN END 

150 C% = A / 256 

200 POKE 71 ,C% 

300 B% - A / 256 

310 B = B% * 256 

320 B% = A - B 

350 POKE 70, B% 

400 POKE 59,249 

500 POKE 58,64 

550 PRINT 

600 CALL 65209 

650 PRINT 

700 GOTO 100 



TO HEX OUTPUT 
Read the input . 

Provide a way to end the program. 
Isolate the high byte. 
Set YREG for PRNTYX call. 
Get remainder from A/256. 
For low byte (XREG) POKE. 



Set PCII to $F9. 

Set PCL to $40. 

Print a blank line. 

Entry point in GO processor is FEB9. 

Print a blank line. 

Go around for another number. 



STEP AND TRACE PECULIARITIES 

The Step and Trace functions in the Old Monitor incorrectly display 
register contents under some circumstances. The STEP routine detects 
and gives special attention to JSR, RTS, JMP, JMP indirect, RTI, and 
BRK instructions. In each case, the register contents are displayed 
from the SAVE area at $45-49. However, there is no SAVE call after 
"execution" of these instructions, as there is for normally traced 
instructions, so the registers displayed are those present in the 
SAVE area before execution of this instruction. 

Therefore, on JSR and RTS, the displayed contents of the S-reg are 
incorrect. On the first instruction after a JSR or RTS, the S-reg 
displays correctly, unless that also is an RTS or JSR. 
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The Step and Trace routines are not incorrect in handling of a BRK 

instruction. That is, the address displayed for the BltK is correct, 
instead of being off by two bytes, because the BRK is detected by the 
STEP routine instead of being executed by the 6502. 

Although step and trace can be very helpful for some program 
debugging tasks, they cannot he used in tracing calls to the Monitor 
(generally including "print" output) or for programs which use AIL, I! 
thru A4L.H. 

Because of the lack of "CLD" at PCADJ (SF953), incorrect addresses 
will be displayed if you set decimal mode (SED) within the program 
being traced or stepped. 



!T 
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